VSCodeでPython開発環境を整える！拡張機能からインタープリタ設定まで

準備・環境構築

※本記事のコードや情報は執筆時点の仕様に基づいています。投資は自己責任であり、必ずデモ環境や少額資金でテストした上で運用してください。

Pythonのインストールが完了し、コマンドプロンプトからスクリプトを実行できるようになったら、次に取り組むべきは開発エディタの整備です。メモ帳でもコードは書けますが、補完機能やデバッグ機能がないため、開発効率は大幅に低下します。

現在、Python開発エディタの事実上の標準となっているのがVisual Studio Code（以下、VS Code）です。無料で利用でき、拡張機能によってPython専用IDEに匹敵する機能を備えることができます。

この記事では、VS Codeのインストールから、Python拡張機能の導入、インタープリタの設定、仮想環境との連携、そして実際にコードを実行するところまで、初心者が迷わずに進められるステップ形式で解説します。

VS Codeのインストール

まずはVS Code本体をWindowsにインストールします。

ダウンロードとインストーラーの実行

VS Codeの公式サイト（https://code.visualstudio.com/）にアクセスし、「Download for Windows」ボタンをクリックしてください。

ダウンロードされるファイルは VSCodeUserSetup-x64-x.xx.x.exe という形式です。ダウンロード完了後、ダブルクリックしてインストーラーを起動します。

インストール時に必ずチェックすべきオプション

インストーラーの「追加タスクの選択」画面では、以下の項目にすべてチェックを入れてください。

  • 「PATHへの追加」: コマンドプロンプトから code コマンドでVS Codeを起動できるようになる
  • 「エクスプローラーのファイルコンテキストメニューに追加」: ファイルを右クリックしてVS Codeで開けるようになる
  • 「エクスプローラーのディレクトリコンテキストメニューに追加」: フォルダを右クリックしてVS Codeで開けるようになる
  • 「サポートされているファイルの種類のエディターとして登録する」: .py ファイルのダブルクリックでVS Codeが開く

これらのオプションは後から設定し直すのが手間です。インストール時にすべてチェックを入れておくことを強く推奨します。

インストール後の初回起動

インストール完了後、VS Codeを起動すると「Get Started」タブが表示されます。テーマの選択画面が表示された場合は、好みの配色を選んでください。機能面への影響はありません。

日本語化は次のステップで行います。

必須拡張機能の導入

VS Code単体ではPythonの補完やデバッグ機能は動作しません。拡張機能をインストールすることで、Python専用の開発環境が構築されます。

拡張機能のインストール方法

VS Codeの左サイドバーにある四角形が4つ並んだアイコン（Extensions）をクリックするか、Ctrl + Shift + X を押して拡張機能パネルを開きます。

上部の検索ボックスにキーワードを入力し、該当する拡張機能の「Install」ボタンをクリックするだけで導入は完了です。

導入すべき拡張機能一覧

以下の拡張機能を順番にインストールしてください。

拡張機能名 提供元 役割
Python Microsoft Python言語サポートの中核。補完・Lint・デバッグを統合
Pylance Microsoft 高速な型チェックとIntelliSense（自動補完）を提供
Japanese Language Pack for VS Code Microsoft VS Codeのメニューを日本語化
indent-rainbow oderwat インデントを色分け表示。Pythonではインデントが文法の一部のため必須級
Error Lens Alexander エラー内容をコード行の横にインライン表示

Python拡張機能のインストール手順

  1. Ctrl + Shift + X で拡張機能パネルを開く
  2. 検索ボックスに「Python」と入力する
  3. 提供元が「Microsoft」のPython拡張機能を選択する
  4. 「Install」をクリックする

インストールが完了すると、Pylanceも自動的に一緒にインストールされます。

Python拡張機能は必ずMicrosoft公式のものを選択してください。類似名称のサードパーティ製拡張機能が存在するため、提供元の確認が重要です。

日本語化の適用

Japanese Language Pack をインストールすると、右下に「Restart to apply」という通知が表示されます。クリックしてVS Codeを再起動すると、メニューが日本語に切り替わります。

Pythonインタープリタの設定

拡張機能の導入が完了したら、VS CodeがどのPythonを使用するかを明示的に指定する必要があります。

インタープリタとは何か

インタープリタとは、Pythonコードを解釈・実行するプログラム本体のことです。PCに複数バージョンのPythonがインストールされている場合、どのバージョンを使うかをVS Codeに指示する必要があります。

インタープリタの選択手順

  1. VS Code上で任意の .py ファイルを開く（新規作成でも可）
  2. Ctrl + Shift + P を押してコマンドパレットを開く
  3. 「Python: Select Interpreter」と入力して選択する
  4. インストール済みのPythonバージョン一覧が表示される
  5. 使用したいバージョン（例：Python 3.12.x）をクリックする

選択結果の確認方法

インタープリタの選択が完了すると、VS Codeのウィンドウ右下のステータスバーに選択したPythonバージョンが表示されます。


Python 3.12.x 64-bit

この表示が正しいバージョンを示していることを確認してください。ステータスバーのバージョン表示をクリックすれば、いつでもインタープリタを切り替えることができます。

インタープリタが未選択の状態では、コード補完やデバッグが正常に動作しません。.py ファイルを初めて開いた際に必ず設定してください。

ワークスペースとフォルダ管理

VS Codeは「フォルダ単位」でプロジェクトを管理する設計になっています。ファイルを1つずつ開くのではなく、プロジェクトフォルダを開く運用が推奨されます。

プロジェクトフォルダの作成と展開

以下の手順で、Python開発用のフォルダを作成してVS Codeで開きます。

  1. エクスプローラーで任意の場所に python-projects フォルダを作成する
  2. そのフォルダを右クリックし「Codeで開く」を選択する（インストール時のオプション設定済みの場合）
  3. VS Codeの左サイドバーにフォルダツリーが表示される

フォルダ構成の推奨パターン

開発を進めるうちにファイルが増えていきます。以下のようなフォルダ構成をあらかじめ作っておくと整理しやすいです。


python-projects/
├── data/           # CSVなどのデータファイル
├── scripts/        # 実行用スクリプト
├── notebooks/      # Jupyter Notebook用
└── tests/          # テストコード

settings.jsonによるプロジェクト固有の設定

VS Codeでは、プロジェクトフォルダ内に .vscode/settings.json を配置することで、プロジェクトごとに異なる設定を適用できます。

Ctrl + Shift + P でコマンドパレットを開き、「Preferences: Open Workspace Settings (JSON)」を選択すると、.vscode/settings.json が自動生成されます。

以下は推奨設定の例です。


{
    "python.analysis.typeCheckingMode": "basic",
    "editor.formatOnSave": true,
    "editor.tabSize": 4,
    "files.encoding": "utf8",
    "python.analysis.autoImportCompletions": true
}
設定項目 効果
typeCheckingMode 型チェックの厳格さを設定（off / basic / strict）
formatOnSave 保存時にコードを自動整形する
tabSize インデント幅を4スペースに固定
files.encoding ファイルの文字コードをUTF-8に統一
autoImportCompletions import文の自動補完を有効化

【コピペOK】VS Code上でPythonスクリプトを実行する

環境設定が完了したら、実際にVS Code上でPythonコードを実行します。

実行方法1：ターミナルから実行する

VS Code内にはターミナル（コマンドプロンプト相当）が統合されています。

  1. Ctrl + @（バッククォート）を押してターミナルパネルを開く
  2. 以下のコマンドを入力して実行する

python scripts/test_run.py

以下のテスト用スクリプトを scripts/test_run.py として保存してください。


import sys
import platform

# ==============================
# VS Code動作確認スクリプト
# ==============================
def main():
    print("=== VS Code Python環境チェック ===")
    print(f"Pythonバージョン : {sys.version}")
    print(f"実行パス         : {sys.executable}")
    print(f"OS               : {platform.system()} {platform.release()}")
    print(f"アーキテクチャ   : {platform.machine()}")
    print("=== チェック完了 ===")

if __name__ == "__main__":
    main()

実行方法2：再生ボタンから実行する

Python拡張機能がインストールされている場合、.py ファイルを開いた状態でエディタ右上に表示される再生ボタン（▶）をクリックするだけでスクリプトを実行できます。

ターミナルが自動的に開き、実行結果が表示されます。この方法が最も手軽です。

実行方法3：デバッグモードで実行する

F5 キーを押すと、デバッグモードでスクリプトが実行されます。初回実行時は「デバッグ構成の選択」が表示されるため、「Python File」を選択してください。

デバッグモードでは以下の機能が利用できます。

  • ブレークポイント: コード行の左余白をクリックして設定。その行で実行が一時停止する
  • 変数ウォッチ: 一時停止中に変数の値をリアルタイムで確認できる
  • ステップ実行: 1行ずつコードを進めて動作を追跡できる

デバッグモードは「コードが動かない原因」を特定する最も効率的な方法です。早い段階から使い方に慣れておくことを推奨します。

仮想環境（venv）との連携

プロジェクトごとにライブラリのバージョンを管理するために、仮想環境の利用が推奨されます。

仮想環境の作成

VS Codeのターミナルで以下のコマンドを実行してください。


python -m venv .venv

プロジェクトフォルダ内に .venv フォルダが作成されます。

仮想環境の有効化

Windowsのコマンドプロンプトでは以下のコマンドで有効化します。


.venvScriptsactivate

有効化されると、ターミナルのプロンプト先頭に (.venv) と表示されます。

VS Codeでの自動認識

VS Codeは .venv フォルダを自動検出し、インタープリタの候補として表示します。Ctrl + Shift + P →「Python: Select Interpreter」で .venv 内のPythonを選択すれば、以降はその仮想環境が自動的に使用されます。

仮想環境を使うことで、プロジェクトAとプロジェクトBで異なるバージョンのライブラリを共存させることが可能になります。

よくあるエラーと対処法

コード補完（IntelliSense）が動作しない

以下の順番で確認してください。

  1. Python拡張機能（Microsoft製）がインストールされているか
  2. Pylanceが有効になっているか
  3. インタープリタが正しく選択されているか（右下のステータスバーを確認）

すべて正常であるにもかかわらず補完が動作しない場合は、Ctrl + Shift + P →「Python: Clear Cache and Reload Window」を実行してください。

ターミナルで「activate.ps1 は〜実行できません」と表示される

PowerShellのセキュリティポリシーにより、スクリプトの実行が制限されている場合に発生します。以下の2つの対処法があります。

  • 対処法1: ターミナルをPowerShellからコマンドプロンプトに切り替える（ターミナル右上のドロップダウンで「Command Prompt」を選択）
  • 対処法2: PowerShellで以下を実行して実行ポリシーを変更する

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

保存時に自動整形が効かない

settings.json に "editor.formatOnSave": true を設定しているにもかかわらず整形が行われない場合、フォーマッターがインストールされていない可能性があります。

ターミナルで以下を実行し、フォーマッターを導入してください。


pip install black

その後、settings.json に以下を追加します。


{
    "python.formatting.provider": "none",
    "[python]": {
        "editor.defaultFormatter": "ms-python.black-formatter"
    }
}

2024年以降のPython拡張機能では、Black Formatterは別途拡張機能としてインストールする必要があります。拡張機能パネルで「Black Formatter」（Microsoft製）をインストールしてください。

まとめ

VS CodeでPython開発環境を整えるために必要な手順は、以下のとおりです。

  • VS Code公式サイトからインストールし、PATH追加・コンテキストメニュー追加のオプションをすべて有効化する
  • Python拡張機能（Microsoft製）を最優先でインストールする
  • Ctrl + Shift + P →「Python: Select Interpreter」で使用するPythonバージョンを明示的に指定する
  • プロジェクトフォルダ単位で管理し、.vscode/settings.json で設定を統一する
  • 仮想環境（.venv）を作成し、プロジェクトごとにライブラリを分離する

VS Codeの環境構築は一度完了すれば、以降のすべての開発作業の効率を大幅に向上させます。次のステップとして、yfinanceを使った株価データの取得や、pandasによるデータ分析スクリプトの作成に進んでください。

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