自分のパソコンにPython環境を作る

ここまでは、ブラウザの実行欄でPythonを動かしてきました。手軽ですが、仕事で使うには、足りないところがあります。

このレッスンでは、自分のパソコンに、Pythonを動かす環境を作ります。流れは、次の5つです。

このレッスンのコードは、すべて自分のパソコンで操作するものです。このページでは動かさず、手順と、画面に出る内容を示します。Windows を中心に説明し、Mac の違いを補足します。

1. ブラウザで、Python の公式サイト（python.org）を開く。「Downloads」から、最新の安定版のインストーラーをダウンロードする。公式以外のサイトから入れてはいけません。（この講座の実行欄は 3.12 です。3.12 以降なら、同じように動きます）
2. ダウンロードしたファイルを、ダブルクリックで開く。最初の画面の下にある「Add python.exe to PATH」に、チェックを入れる。 これを忘れると、あとで困ります。
3. 「Install Now」を押す。終わったら「Setup was successful」と出るので、Close を押す。
4. スタートメニューで「cmd」と入力し、「コマンド プロンプト」を開く。
5. 次のように打ち、Enter を押す。

C:\Users\tanaka> python --version
Python 3.12.8

Python 3.12.8 のように、バージョンが出れば成功です。（数字は、入れた版によって変わります）

Mac の場合 公式サイトのインストーラーで入れ、「ターミナル」を開いて、python3 --version と打ちます。Mac では、python ではなく python3 と打つのがふつうです。以降の python は、Mac では python3 に読み替えてください。

コマンドプロンプトの左側に出ている文字は、「今いる場所（フォルダ）」です。命令は、この場所を基準に動きます。

次に、仮想環境の考え方です。Python の道具（pandas など）を、パソコン全体に入れていくと、ある仕事では新しい版、別の仕事では古い版が必要、という場面で困ります。そこで、仕事（プロジェクト）ごとに専用の部屋を作り、その中だけに道具を入れます。

パソコンの Python
pandas 2.2
openpyxl
（すべての仕事で共有。
 版を変えると、他の仕事が動かなくなることも）

売上レポート/.venv
pandas 2.2
openpyxl

経費チェック/.venv
pandas 2.1
（それぞれ独立。消すのも簡単）

仮想環境で使っている道具の一覧は、requirements.txtというファイルに書き出せます。別のパソコンや、後任の人は、このファイルから同じ道具を、そろえ直せます。道具を入れるときに使うのが、pipという命令です。

ここからは、自分のパソコンで、順に操作します。1つ終わるたびに、結果を確かめてください。

1. エクスプローラーで、C:\Users\tanaka\python-work のようなフォルダを作る。フォルダの名前は、半角の英数字にします。日本語や空白が入っていると、うまく動かないことがあります。
2. その中に、sales-report フォルダを作る。（ユーザー名が日本語のときは、C:\work\python のように、場所そのものを変えます。OneDrive で同期されるフォルダ（デスクトップなど）も避けます）

エディタは、コードを書くための道具です。メモ帳でも書けますが、色分けや入力の補助がある Visual Studio Code（VS Code） が定番です。無料ですが、会社のルールの確認を忘れずに。

1. VS Code の公式サイト（code.visualstudio.com）から入れる。
2. 起動して、左端の四角が並んだアイコン（拡張機能）を開き、「Python」（発行元は Microsoft）を入れる。
3. 「ファイル」→「フォルダーを開く」で、sales-report を開く。
4. 新しいファイルを作り、hello.py という名前で保存する。次の内容を書いて、Ctrl + S で保存する。

name = "田中"
print(f"こんにちは、{name}さん。Python が動きました。")

5. 「ターミナル」→「新しいターミナル」を開く。右上の「＋」の横の「▼」から Command Prompt（コマンド プロンプト） を選ぶと、この講座の手順どおりに進められます。
6. 次のように打つ。

C:\Users\tanaka\python-work\sales-report> python hello.py
こんにちは、田中さん。Python が動きました。

画面に日本語が出れば、最初の1本は成功です。

1. 同じターミナルで、仮想環境を作る。.venv は、専用の部屋のフォルダの名前です。

python -m venv .venv

2. 有効にする（その部屋に入る）。

.venv\Scripts\activate

3. 行の先頭に (.venv) と出れば、部屋に入っています。

(.venv) C:\Users\tanaka\python-work\sales-report>

Mac では、3行目の代わりに source .venv/bin/activate と打ちます。部屋から出るときは deactivate です。

1. pandas と openpyxl（Excel を扱う道具）を入れる。数分かかることがあります。

(.venv) C:\...\sales-report> python -m pip install pandas openpyxl

2. 入ったか確かめる。

(.venv) C:\...\sales-report> python -c "import pandas; print(pandas.__version__)"

3. 今の道具の一覧を、requirements.txt に書き出す。

(.venv) C:\...\sales-report> pip freeze > requirements.txt

requirements.txt の中身は、次のような形です。（バージョンの数字は、環境によって変わります）

et_xmlfile==2.0.0
numpy==2.1.3
openpyxl==3.1.5
pandas==2.2.3
python-dateutil==2.9.0.post0
pytz==2024.2
six==1.16.0
tzdata==2024.2

4. 別のパソコンや、新しい仮想環境では、この一覧から入れ直せる。

(.venv) C:\...\sales-report> pip install -r requirements.txt

フォルダは、次のようになっています。.venv の中身は大きく、人に渡す必要はありません。渡すのは、.py と requirements.txt です。

sales-report/
  .venv/              専用の部屋（人には渡さない）
  hello.py
  requirements.txt

うまくいかないときは、画面のメッセージが手がかりです。よくある例を挙げます。

pip install が会社の制限で通らないときは、社内用の道具置き場（ミラー）を案内されることがあります。証明書の確認を無効にするような裏技は、許可なく使わないでください。

仕上げに、できたかを自分で確かめましょう。

• □ python --version で、バージョンが表示される
• □ hello.py を保存して、python hello.py で動かせた
• □ python -m venv .venv で仮想環境を作り、(.venv) が出ることを確認した
• □ pip install pandas openpyxl が通り、import pandas ができる
• □ requirements.txt を書き出せた
• □ 作業フォルダの名前が、半角英数字になっている
• □ 会社のルールで、これらの操作が許可されていることを確認した