Python設定と入門：初心者向けガイド

Pythonの世界へようこそ！あなたは、そのシンプルさ、パワー、多用途性で評価されている言語を学ぶことを選びました。Pythonは、Webアプリケーション、データサイエンス、人工知能、自動化など、さまざまな分野の原動力となっています。初心者にとって、そのクリーンな構文と読みやすいコードは、最初の言語として理想的です。

ただし、最初のコードを書く前に、開発環境を正しく設定する必要があります。適切な設定は、将来のすべてのプロジェクトが構築される基盤となります。これにより、よくあるフラストレーションを防ぎ、スムーズで生産的な学習体験を保証します。この包括的なガイドでは、コンピューターへのPythonのインストールから、仮想環境を使用したプロジェクトの依存関係の管理、そして最初のスクリプトの実行まで、プロセス全体を順を追って説明します。Pythonの旅を確実なスタートを切るために、必要なすべてのコマンドを詳細に解説します。

💡

美しいAPIドキュメントを生成する優れたAPIテストツールをお探しですか？

開発チームが最大限の生産性で協力するための統合されたオールインワンプラットフォームをお探しですか？

Apidogはあなたのすべての要求に応え、Postmanをはるかに手頃な価格で置き換えます！

button

このチュートリアルは、まったくの初心者向けに設計されています。事前のプログラミング知識は不要とします。私たちは、初日からベストプラクティス、特にプロのPython開発者にとって重要なスキルである仮想環境の使用を確立することに焦点を当てます。

I. Pythonのインストール：最初のステップ

最初のステップは、システムにPythonインタープリターをインストールすることです。インタープリターは、Pythonコードを読み込み、書かれた命令を実行するプログラムです。Python 2はサポートされなくなったため、Python 3を使用します。

Pythonを正しくインストールし、コマンドラインインターフェイス（CLI）—WindowsのコマンドプロンプトまたはPowerShell、macOSおよびLinuxのターミナル—からアクセスできることを確認することが重要です。

A. Windowsへのインストール

WindowsにはPythonがプリインストールされていません。インストールする推奨される方法は、公式インストーラーを使用することです。

インストーラーのダウンロード： Webブラウザを開き、公式PythonウェブサイトのWindowsダウンロードページにアクセスします。最新の安定版をダウンロードするためのボタンが表示されるはずです。「Windows installer (64-bit)」をダウンロードしてください。

インストーラーの実行： ダウンロードが完了したら、インストーラーの実行可能ファイルを実行します。インストールウィンドウが表示されます。

重要なステップ：PythonをPATHに追加： 「Install Now」をクリックする前に、ウィンドウの下部を見てください。「Add Python to PATH」またはそれに類するラベルのチェックボックスが表示されます。このボックスにチェックを入れる必要があります。 このステップにより、任意のディレクトリからコマンドプロンプトでPythonを実行できるようになります。これは、Windowsの初心者にとって最も一般的な落とし穴の1つです。

インストール： 「Install Now」をクリックして、推奨設定でインストールを開始します。インストールプロセスはプログレスバーで表示されます。

インストールの確認： インストールが完了したら、成功したことを確認する必要があります。コマンドプロンプトまたはPowerShellを開きます。これらはスタートメニューで検索することで見つけられます。表示されたウィンドウで、以下のコマンドを入力してEnterキーを押します：Bash

python --version

インストールが成功していれば、画面にPythonのバージョン番号が表示されます。例えば、Python 3.12.3のようになります。

pipインストールの確認： Pythonのパッケージマネージャーであるpipは、Pythonと一緒に自動的にインストールされます。これは、サードパーティライブラリをインストールするために使用するツールです。以下のコマンドでインストールを確認します：Bash

pip --version

pipのバージョンと場所が表示されるはずです。

B. macOSへのインストール

macOSの最新バージョンには、Python 2のプリインストールバージョンが含まれていることがよくあります。ただし、このバージョンは古く、使用すべきではありません。Python 3をインストールする必要があります。

推奨される方法は、Windowsと同様に公式インストーラーを使用することです。

インストーラーのダウンロード： 公式PythonウェブサイトのmacOSダウンロードページにアクセスします。最新の安定版の「macOS 64-bit universal2 installer」をダウンロードしてください。

インストーラーの実行： ダウンロードした.pkgファイルを開きます。インストーラーがステップを案内します。ライセンスに同意し、標準インストールに進みます。これにより、Python 3が/Applicationsフォルダにインストールされ、必要なリンクが作成されます。

インストールの確認： ターミナルアプリケーションを開きます（Applications/Utilities内にあるか、Spotlightで検索できます）。新しいPython 3のインストールを確認するには、以下を入力します：Bash

python3 --version

これにより、インストールしたバージョンが出力されるはずです。macOSでは、python3コマンドはPython 3インタープリターを明示的に呼び出すために使用され、pythonは古いPython 2を指している場合があります。

pipの確認： 同様に、pipのインストールを確認します：Bash

pip3 --version

Python 3のインストールでパッケージを管理するには、おそらくpip3を使用する必要があります。

C. Linuxへのインストール

ほとんどのLinuxディストリビューションにはPython 3がプリインストールされています。ただし、ディストリビューションのパッケージリポジトリから最新バージョンを取得し、pipやvenvのような必要なツールも存在することを確認するのが良い習慣です。

ターミナルを開きます。

パッケージマネージャーの更新： まず、ローカルのパッケージリストを更新します。

Debian、Ubuntu、または派生版の場合：Bash

sudo apt update

Fedora、CentOS、またはRHELの場合：Bash

sudo dnf check-update

Pythonのインストール： 次に、Python 3パッケージと、pip、そして仮想環境の作成に使用されるvenvモジュールをインストールします。

Debian、Ubuntu、または派生版の場合：Bash

sudo apt install python3 python3-pip python3-venv

Fedora、CentOS、またはRHELの場合：Bash

sudo dnf install python3 python3-pip

インストールの確認： ターミナルを使用してインストールされたバージョンを確認します。コマンドは通常python3です。Bash

python3 --version

そしてpipを確認します：Bash

pip3 --version

II. 仮想環境：プロフェッショナルなプロジェクト分離

Pythonがインストールされたので、パッケージをグローバルにインストールしたくなるかもしれません。待ってください。 新しいPython開発者にとって最も重要なベストプラクティスは、すべてのプロジェクトに仮想環境を使用することです。

なぜ仮想環境を使用するのか？

2つの異なるプロジェクトに取り組んでいると想像してください。プロジェクトAは特定のライブラリのバージョン1.0を必要とし、プロジェクトBは同じライブラリのバージョン2.0を必要とします。これらのライブラリをグローバルにインストールすると、常にバージョンを切り替える必要があり、どちらかのプロジェクトが常に壊れた状態になります。

仮想環境は、特定のバージョンのPythonと、プロジェクトが必要とするすべての特定のパッケージおよびライブラリを保持する、自己完結型で分離されたディレクトリです。これは、グローバルなPythonインストールや他の仮想環境には影響しません。

利点：

依存関係の競合を回避： 各プロジェクトの依存関係を分離し、独立させます。
システムをクリーンに保つ： グローバルなPythonインストールは、プロジェクト固有のパッケージの混乱から解放され、手つかずの状態を保ちます。
再現性を確保： 別のマシンでもプロジェクトの正確な環境を簡単に再現できます。

Python 3で仮想環境を作成するための標準的な組み込み方法であるvenvモジュールを使用します。

仮想環境の作成と使用

ワークフロー全体を見ていきましょう。

プロジェクトディレクトリの作成： まず、新しいプロジェクト用のフォルダを作成します。コマンドラインインターフェイスを開き、以下のコマンドを実行します：Bash

mkdir my_first_project
cd my_first_project

これにより、my_first_projectという新しいディレクトリが作成され、その中に移動します。

仮想環境の作成： 次に、プロジェクトフォルダ内で以下のコマンドを実行します。このコマンドは、Pythonにvenvモジュールを実行させ、venvという名前のフォルダに新しい仮想環境を作成するように指示します。

macOSおよびLinuxの場合：Bash

python3 -m venv venv

Windowsの場合：Bash

python -m venv venv

これを実行すると、my_first_project内にvenvという新しいフォルダが表示されます。このフォルダにはPythonインタープリターのコピーが含まれており、プロジェクト固有のパッケージがここにインストールされます。このフォルダをvenvまたは.venvと名付けるのは一般的な慣習です。

仮想環境のアクティベート： 環境を作成するだけでは不十分です。それを「アクティベート」する必要があります。環境をアクティベートすると、シェルのプロンプトが変更され、その環境固有のPythonおよびpip実行ファイルを指すようになります。

Windowsの場合（コマンドプロンプトを使用）：Bash

venv\Scripts\activate.bat

Windowsの場合（PowerShellを使用）：PowerShell

.\venv\Scripts\Activate.ps1

（最初にSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Processを実行して実行ポリシーを変更する必要がある場合があります）

macOSおよびLinuxの場合：Bash

source venv/bin/activate

アクティベートされると、コマンドプロンプトの先頭に環境の名前が括弧で表示されます。例えば、(venv) C:\Users\YourUser\my_first_project>のようになります。これは、仮想環境がアクティブであることを示しています。

仮想環境のディアクティベート： プロジェクトでの作業が終了したら、環境をディアクティベートして通常のシェルに戻ることができます。以下のコマンドを入力するだけです：Bash

deactivate

プロンプトから(venv)のプレフィックスが消えます。

III. `pip`を使用したパッケージの管理

仮想環境がアクティブになったので、プロジェクトのパッケージを安全にインストールできます。これに使用するツールはpipです。環境がアクティブな場合、pipコマンドはその環境に自動的にリンクされます。

コア`pip`コマンド

HTTPリクエストを行うために使用されるrequestsという人気のあるパッケージをインストールしてみましょう。

パッケージのインストール： venvがアクティブであることを確認し、以下を実行します：Bash

pip install requests

pipは、Python Package Index (PyPI) からrequestsパッケージとそのすべての依存関係をダウンロードし、それらを直接venvフォルダにインストールします。グローバルなPythonインストールは手つかずのままです。

インストール済みパッケージのリスト表示： 現在（アクティブな）環境にインストールされているパッケージを確認するには、以下を使用します：Bash

pip list

requestsとその依存関係がリスト表示されますが、グローバルなPythonまたは他の環境にインストールされているパッケージは表示されません。

requirements.txtファイルの作成： 他のユーザーとプロジェクトを共有し、彼らがあなたの環境を再現できるようにするにはどうすればよいですか？これを行うには、requirementsファイルを使用します。標準的な慣習として、このファイルの名前をrequirements.txtとします。

pip freezeコマンドを使用すると、インストールされているすべてのパッケージとその正確なバージョンをリストアップするこのファイルを自動的に生成できます。Bash

pip freeze > requirements.txt

>記号は、コマンドの出力をrequirements.txtファイルにリダイレクトします。このファイルを開くと、パッケージのバージョンリストが表示されます。

requirements.txtファイルからのインストール： 他のユーザー（または将来の自分自身）がプロジェクトをセットアップしたい場合、新しい仮想環境を作成してアクティベートし、以下のコマンドを実行することで、必要なすべてのパッケージを一括でインストールできます：Bash

pip install -r requirements.txt

このコマンドは、pipにファイルを読み込み、その中にリストされているすべてのパッケージをインストールするように指示します。

パッケージのアンインストール： 不要になったパッケージがある場合は、削除できます：Bash

pip uninstall requests

pipはパッケージを削除する前に確認を求めます。

IV. 最初のPythonスクリプト

完全で隔離された開発環境が整いました。ついにコードを書く時間です！

コードを書く

Pythonファイルの作成： お気に入りのテキストエディタ（VS Code、Sublime Text、あるいはメモ帳など）を使用して、my_first_projectディレクトリ内にapp.pyという名前の新しいファイルを作成します。venvディレクトリの中ではなく、同じフォルダにあることを確認してください。

Pythonコードの追加： app.pyを開き、以下のコードを入力します。このスクリプトはあなたの名前を尋ね、パーソナライズされた挨拶を表示します。Python

# A simple Python script to greet the user

def get_greeting(name):
    """Generates a personalized greeting."""
    if not name:
        return "Hello, mysterious stranger!"
    else:
        return f"Hello, {name}! Welcome to the world of Python."

def main():
    """Main function to run the program."""
    print("Welcome to your first Python application!")
    user_name = input("Please enter your name: ")
    message = get_greeting(user_name.strip())
    print(message)

if __name__ == "__main__":
    main()

defは関数を定義します。
input()はユーザーに入力を促し、それを文字列として読み取ります。
.strip()は、入力の先頭または末尾にある空白文字を削除します。
f"..."はf-stringで、文字列リテラル内に式を埋め込むためのモダンで便利な方法です。
if __name__ == "__main__":ブロックは標準的なPythonの慣習です。これにより、main()内のコードは、スクリプトが直接実行された場合のみ実行されることが保証されます（別のスクリプトにモジュールとしてインポートされた場合は実行されません）。

スクリプトの実行

環境がアクティブであることを確認： コマンドラインインターフェイスに戻ります。my_first_projectディレクトリにいること、そして(venv)のプレフィックスが表示されていることを確認してください。

スクリプトの実行： プログラムを実行するには、Pythonインタープリターを呼び出し、スクリプトファイルの名前を渡します。

macOSおよびLinuxの場合：Bash

python3 app.py

Windowsの場合：Bash

python app.py

プログラムとの対話： スクリプトはターミナルで実行されます。まず「Welcome to your first Python application!」と表示され、次にあなたの名前を尋ねます。名前を入力してEnterキーを押してください。すると、スクリプトがパーソナライズされた挨拶を表示します。

おめでとうございます！プロフェッショナルなPython開発環境を正常にセットアップし、パッケージを管理し、最初のPythonアプリケーションを作成して実行しました。これにより、あらゆる規模のプロジェクトで役立つワークフローを習得しました。ここからは、言語自体—その構文、データ構造、そして広大なライブラリのエコシステム—を学ぶ旅が始まります。しかし、この強固な基盤があれば、前途の冒険に完璧に備えることができます。

💡