html_content = """ VSCode Python環境構築・操作ガイド(サプー解説まとめ)
YouTube解説まとめ · 実践手順書

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

サプー「【VSCode】無料エディターのVSCodeをPythonコーディング用にカスタマイズしよう!〜初心者向け〜」動画準拠の手順書

1 インストール & 日本語化
  1. VSCodeのダウンロードと通常インストール

    Microsoft公式サイトからPC(Windows / Mac)に対応したインストーラーをダウンロードし、標準設定のまま完了させます。

  2. 拡張機能画面(Extensions)を開く

    画面左端のアクティビティバーにある「四角いブロック(パズル)型アイコン」をクリックします(または Ctrl + Shift + X)。

  3. 「Japanese Language Pack for VS Code」をインストール

    上部の検索バーに Japanese と入力し、Microsoft公式パックの「Install」をクリック。完了後、右下に表示される「Restart」ボタンを押して再起動するとメニューが日本語化されます。

2 導入すべき拡張機能(4選)
Python必須ツール
Python (Microsoft公式) 必須

構文ハイライト、コード補完、右上の「▷実行ボタン」の追加、インタープリタ切り替えなどPython開発の根幹機能。

Visual Studio IntelliCode 推奨

AIが文脈を読み、ライブラリ(pandas等)の候補や引数の解説ポップアップを高精度にサジェスト。

コーディング補助ツール
Python Indent 推奨

リスト内改行やネスト時に、開始位置を自動でPythonの標準インデント規則に合わせて配置。

autoDocstring (Python Docstring Generator) 推奨

関数直下で """ と打ってEnterを押すだけで、引数・戻り値の型アノテーション枠を含むDocstringを自動挿入。

3 作業フォルダ作成から実行までの手順
  1. 作業用フォルダを開く

    「ファイル」>「フォルダーを開く」から、スクリプトを保存する任意のフォルダを選択。「フォルダーの作成者を信頼しますか?」が出たら「信頼する」を選択。

  2. Pythonファイルの新規作成

    エクスプローラー左上の「新しいファイル」アイコンをクリックし、code.py などの拡張子 .py を付けたファイル名を入力してEnter。

  3. コードの記述と保存

    コードを記述します。編集直後はタブ名に「白丸(●)」が表示されます。Ctrl + S(Mac: Cmd + S)で保存すると白丸が消えます。

  4. 実行ボタンをクリック

    エディタ画面の右上にある「再生ボタン(▷)」をクリックすると、下部にターミナルが立ち上がり、自動で python code.py が実行されます。

💡 インタープリタ(仮想環境・Pythonバージョン)の変更方法
画面左下(または右下ステータスバー)に表示されているPythonバージョン(例: 3.10.x)をクリックするか、コマンドパレットから Python: Select Interpreter を呼び出して対象のPython環境を切り替え可能です。
4 知っておくべき必須ショートカット & 検索
機能 Windows Mac 操作詳細
ファイル内 検索 / 置換 Ctrl + F Cmd + F 右上に検索バー。左の「>」展開で置換入力。個別置換・一括置換ボタンあり。
プロジェクト全体検索 Ctrl + Shift + F Cmd + Shift + F 開いているフォルダ内すべてのファイルを横断検索。クリックで該当局へジャンプ。
定義へジャンプ / 逆参照 F12 F12 関数名にカーソルを置いて押すと定義元へ。定義元で押せば呼び出し元リストを表示。
ファイル名 クイックオープン Ctrl + P Cmd + P 上部に検索バー。ファイル名の一部を入力して即座に該当ファイルを開く。
コマンドパレット Ctrl + Shift + P (または F1) Cmd + Shift + P (または F1) 設定・拡張機能一覧・エディタ操作など、VSCodeの全機能をあいまい検索して実行。
5 ブレークポイントによるデバッグ(ステップ実行)
  1. ブレークポイントのセット

    確認したい行の行番号のすぐ左側(グレーの領域)をクリックすると「赤い丸」が付きます。プログラムはその直前で一時停止します。

  2. デバッグ開始

    右上の再生ボタン横の下矢印メニューから「Python ファイルのデバッグ」を選択して起動します。

  3. 変数状態のモニタリング

    赤丸行で処理が止まり行がハイライトされます。左側パネルの「変数(Variables)」欄にその時点でのローカル変数の値が一覧表示されます。

  4. 1行ずつ進める(ステップオーバー / イン)

    上部に現れる操作バーの「下向き矢印(ステップオーバー)」を押すと1行ずつ実行が進み、変数がどう変化していくかをリアルタイムに確認できます。

6 エディタの基本設定カスタマイズ & PyCharm比較
初期設定の微調整
  • 設定画面の開き方: Ctrl + ,(Mac: Cmd + ,)
  • フォントサイズ: 「よく使用するもの」内の Font Size を変更(14 → 16など好みに合わせて拡大)。
  • カラーテーマ変更: 「ワークベンチ」>「外観」>「カラーテーマ」から好みの配色を選択(初期設定のDark+が見やすくおすすめ)。
VSCode vs PyCharm の選び方

VSCode

  • 完全無料で制限なし
  • 動作・起動が圧倒的に軽い
  • HTML/JS/シェル等も同一環境で共存
  • (初回のみプラグイン導入が必要)

PyCharm

  • Python特化で設定ゼロで動く
  • コード推論・修正提案が極めて優秀
  • 一部プロ向け機能は有償
  • 環境によってやや動作が重い
""" filename = "vscode_python_setup_guide.html" with open(filename, "w", encoding="utf-8") as f: f.write(html_content) print(f"Generated HTML file: {filename}")