VSCode Python 開発環境セットアップ

1. VSCode のインストール

VSCode（Visual Studio Code）はMicrosoftが開発した無料のコードエディターです。軽量で高機能、豊富な拡張機能により世界中の開発者に愛用されています。

1. 1
   公式サイトからダウンロード

   https://code.visualstudio.com/ にアクセスし、お使いのOSに合ったインストーラーをダウンロードします。

2. 2
   インストールオプション（Windows）

   Windowsの場合、インストール時に以下のオプションにチェックを入れると便利です：

   • 「エクスプローラーのファイルコンテキストメニューに[Codeで開く]アクションを追加する」
   • 「エクスプローラーのディレクトリコンテキストメニューに[Codeで開く]アクションを追加する」
   • 「PATHへの追加」
3. 3
   起動確認

   インストール完了後、VSCodeを起動します。日本語UIにするには次のセクションの拡張機能をインストールします。

2. Python 必須拡張機能

VSCodeの左側の拡張機能アイコン（四角が4つのアイコン）をクリックし、検索ボックスに名前を入力してインストールします。

必須拡張機能

推奨拡張機能

3. Python インタープリターの設定

VSCodeに使用するPythonのバージョンを教える設定です。仮想環境を使っている場合は仮想環境のインタープリターを選択します。

1. 1
   コマンドパレットを開く

   Ctrl + Shift + P（Mac: Cmd + Shift + P）でコマンドパレットを開きます。

2. 2
   「Python: インタープリターを選択」を実行

   コマンドパレットに「Python: Select Interpreter」または「Python: インタープリターを選択」と入力して選択します。

3. 3
   使用するPythonを選択

   表示されるリストから使用したいPythonを選択します。仮想環境（venv）を使っている場合は ./venv/bin/python または ./venv/Scripts/python.exe を選択してください。

4. コードの実行方法

方法1: 再生ボタンで実行

右上の ▶ ボタン（実行ボタン）をクリックするか、Shift + F5 でファイルを実行します。

方法2: ターミナルで実行

Ctrl + `（バッククォート）でターミナルを開き、python ファイル名.py を実行します。

python hello.py

方法3: インタラクティブウィンドウ

コードを選択して右クリック → 「選択範囲をPython インタラクティブで実行」を選ぶと、Jupyter のようなインタラクティブウィンドウで実行できます。

5. デバッグの使い方

デバッグを使うとプログラムを途中で止めて変数の値を確認できます。バグ修正に非常に役立ちます。

ブレークポイントの設定

1. 1
   ブレークポイントを設定

   止めたい行番号の左側をクリックすると赤い丸●が表示されます（ブレークポイント）。

2. 2
   デバッグモードで実行

   F5 を押すか「実行とデバッグ」パネルから「Python ファイル」を選んで実行します。

3. 3
   変数を確認

   ブレークポイントで停止したら、左のパネルで変数の値を確認できます。F10（次の行へ）、F11（関数の中に入る）で一行ずつ実行できます。

デバッグのショートカット

6. コードフォーマッターの設定

コードフォーマッターを使うと、保存するだけでコードのインデントやスペースを自動的に整えてくれます。チーム開発でコードスタイルを統一するのにも役立ちます。

Black のインストールと設定

# Blackをインストール
pip install black

VSCodeの設定（Ctrl+,）で以下を設定するか、settings.json に追加します：

{
  "[python]": {
    "editor.defaultFormatter": "ms-python.black-formatter",
    "editor.formatOnSave": true
  }
}

これで Ctrl+S で保存するたびにコードが自動整形されます。

7. おすすめ settings.json 設定

Ctrl+Shift+P → 「基本設定: ユーザー設定を開く (JSON)」で設定ファイルを開きます。

{
  // エディター基本設定
  "editor.fontSize": 14,
  "editor.tabSize": 4,
  "editor.insertSpaces": true,
  "editor.wordWrap": "on",
  "editor.minimap.enabled": false,
  "editor.rulers": [79, 119],
  "editor.renderWhitespace": "boundary",

  // Python設定
  "python.languageServer": "Pylance",
  "python.analysis.typeCheckingMode": "basic",
  "python.analysis.autoImportCompletions": true,

  // フォーマッター設定
  "[python]": {
    "editor.defaultFormatter": "ms-python.black-formatter",
    "editor.formatOnSave": true,
    "editor.codeActionsOnSave": {
      "source.organizeImports": "explicit"
    }
  },

  // ターミナル設定
  "terminal.integrated.fontSize": 13,

  // ファイル設定
  "files.autoSave": "afterDelay",
  "files.autoSaveDelay": 1000,
  "files.trimTrailingWhitespace": true,
  "files.insertFinalNewline": true,

  // テーマ（お好みで）
  "workbench.colorTheme": "Default Dark Modern",
  "workbench.iconTheme": "material-icon-theme"
}

8. 覚えておきたいショートカット