【備忘録】Windowsで本家PythonとVS Codeを使った開発環境構築ガイド

備忘録
2025.06.14

Python開発を始めるなら、公式のPythonインタープリタとVisual Studio Code（VS Code）の組み合わせは鉄板！Windowsのコマンドプロンプトを使って、仮想環境の管理やrequirements.txtを使ったパッケージ管理まで、初心者でも迷わない手順をまとめました。Anacondaは便利だけど、環境変数のパス設定が非推奨なこともあり、今回は本家Pythonでスッキリ環境構築を目指します。さあ、コードの世界に飛び込む準備はできてる？

1. Pythonのインストール

まずは公式Pythonをインストール。Anacondaじゃないよ、本家だよ！

  1. 公式サイトからダウンロード
    python.orgにアクセス。最新の安定版（例えばPython 3.11.x）を選択し、Windows向けインストーラをダウンロード。
  2. インストール時の注意
    • インストーラを起動したら、「Add Python to PATH」にチェックを入れる。これでpythonコマンドが使えるようになるよ！
    • 「Customize installation」で、pipやドキュメントも一緒にインストールすることを確認。
    • インストール先はデフォルト（C:\Users\<ユーザー名>\AppData\Local\Programs\Python\Python311）でOK。
  3. インストール確認
    コマンドプロンプトを開いて（Win + R → cmd）、以下を実行：python --version pip --versionバージョン情報が表示されれば成功！表示されない場合は、次のステップでパス設定を修正。

2. Python.exeへのパスを通す

Anacondaだと環境変数のパス設定は非推奨だけど、本家Pythonならガンガン設定しちゃおう！

  1. インストール先を確認
    Pythonのインストールフォルダ（例: C:\Users\<ユーザー名>\AppData\Local\Programs\Python\Python311）と、その中のScriptsフォルダ（pip用）をメモ。
  2. 環境変数に追加
    • コマンドプロンプトで以下を実行して環境変数に追加：setx PATH "%PATH%;C:\Users\<ユーザー名>\AppData\Local\Programs\Python\Python311;C:\Users\<ユーザー名>\AppData\Local\Programs\Python\Python311\Scripts"
    • コマンドプロンプトを一旦閉じて再起動。
    • 再度python –versionやpip –versionを実行して確認。ちゃんと表示されればバッチリ！
  3. 小ネタ：パス設定の確認
    環境変数を確認したいときは、コマンドプロンプトでecho %PATH%を試してみて。Pythonのパスが含まれているかチェック！

3. VS Codeのインストールと設定

VS CodeはPython開発の相棒。軽量かつ拡張機能が豊富で、まるでコードの魔法使い！

  1. VS Codeのインストール
    code.visualstudio.comからWindows版をダウンロードしてインストール。特別な設定は不要。
  2. Python拡張機能をインストール
    • VS Codeを開き、左の拡張機能アイコン（Ctrl+Shift+X）をクリック。
    • 「Python」（Microsoft提供）を検索してインストール。
    • ついでに「Pylance」（高速な言語サポート）や「Jupyter」（ノートブック用）も入れておくと便利。
  3. Pythonインタープリタの選択
    • VS CodeでPythonファイル（例: test.py）を開く。
    • 右下のインタープリタ表示（例: 「Python 3.11.x」）をクリックし、インストールしたPythonを選択。
    • コマンドパレット（Ctrl+Shift+P）で「Python: Select Interpreter」を選んでもOK。

4. 仮想環境の作成と管理

仮想環境はプロジェクトごとのパッケージ管理の救世主。依存関係の衝突を防いで、コードをクリーンに保つよ！

  1. 仮想環境の作成
    プロジェクトフォルダ（例: C:\Projects\my_project）を作成し、コマンドプロンプトで移動：cd C:\Projects\my_project python -m venv venvこれでvenvフォルダが作成される。
  2. 仮想環境の有効化
    コマンドプロンプトで以下を実行：venv\Scripts\activateプロンプトが(venv)で始まれば有効化成功！これでpipやPythonコマンドはこの仮想環境に限定される。
  3. 仮想環境の解除
    作業が終わったら以下で解除：deactivate
  4. 小ネタ：仮想環境の確認
    仮想環境内でpip listを実行すると、初期状態ではpipとsetuptoolsだけが表示される。スッキリしてるね！

5. requirements.txtを使ったパッケージ管理

依存パッケージをrequirements.txtで管理すれば、チーム開発や環境再構築が楽ちん！

  1. パッケージのインストール
    仮想環境を有効化した状態で、必要なパッケージをインストール：pip install numpy pandas
  2. requirements.txtの作成
    インストールしたパッケージを記録：pip freeze > requirements.txtこれでrequirements.txtファイルが生成される。内容例：numpy==1.26.0 pandas==2.2.0
  3. パッケージの再インストール
    別の環境で同じパッケージを復元するには：pip install -r requirements.txt
  4. 小ネタ：バージョン管理のコツ
    requirements.txtはGitでバージョン管理しよう。依存関係が変わるたびに更新して、チームメンバーと共有！

6. VS Codeでの開発Tips

VS Codeをフル活用して、Python開発をさらに快適に！

  1. コードフォーマット
    • 「Python」拡張機能でautopep8やblackを有効化。設定例：{ "python.formatting.provider": "black" }保存時に自動整形されるよ！
    • 設定はCtrl+,で「settings.json」を開いて追加。
  2. デバッグ設定
    • launch.jsonを作成してデバッグ環境をカスタマイズ。例：{ "version": "0.2.0", "configurations": [ { "name": "Python: Current File", "type": "python", "request": "launch", "program": "${file}", "console": "integratedTerminal" } ] }F5キーでデバッグ開始！
  3. ターミナルでコマンドプロンプトを指定
    VS Codeのターミナルでコマンドプロンプトを使うには、settings.jsonに以下を追加：{ "terminal.integrated.defaultProfile.windows": "Command Prompt" }

7. まとめと次のステップ

これで本家PythonとVS Codeを使った開発環境構築はバッチリ！仮想環境でプロジェクトを整理し、requirements.txtでパッケージを管理すれば、どんなPythonプロジェクトも怖くない。次は、DjangoやFlaskでWebアプリを作ったり、Jupyterでデータ分析に挑戦してみては？コードの世界は無限大だ！

何かハマったら、コマンドプロンプトでpython –helpやpip –helpを試してみて。Stack Overflowもあなたの味方だよ！

コメント

タイトルとURLをコピーしました