Python開発用にVisual Studio Codeを構成する方法

Pythonは、データ分析、AI、Webアプリなど、あらゆる分野で使われています。WindowsでPython開発を始めるなら、Visual Studio Code（VS Code）を使うのが確実な選択肢です。軽量で柔軟性が高く、拡張機能も豊富です。しかし、特に初心者であれば、正しくセットアップするのは少々面倒な作業です。期待通りに動作しないこともあります。Pythonが動作しない、VS Codeがインタープリターを認識しないなどです。なぜ特定のセットアップで動作し、他のセットアップでは動作しないのかは分かりませんが、適切なインストールと構成が重要です。そこで、ここでは、PythonとVS Codeのインストールから、ストレスなくコーディングを開始できるようにするための構成まで、基本的な事項を網羅した、分かりやすいチュートリアルをご紹介します。

Windows で Python のセットアップを修正し、VS Code を使えるようにする方法

Pythonインタープリタを正しく動作させる

まず、Python が正しくインストールされ、どこからでもアクセスできる必要があります。そうでないと、VS Code が混乱してしまいます。通常は、Python が PATH 環境変数に追加されていることを確認するだけですが、インストーラーが自動的に追加しなかったために、行き詰まることがあります。ターミナルに「Python が認識されません」と表示されたら、それが原因です。これを修正するには、PATH を確認するか、適切なオプションで Python を再インストールする必要があります。Windows では、インストーラーを実行し、「Python を PATH に追加する」というボックスにチェックを入れ、 「すべてのユーザーにインストール」が選択されていることを確認するのが最も簡単な方法です。その後、コマンドプロンプトまたは PowerShell ウィンドウを開き、次を入力します。

python --version

インストールされているPythonのバージョンが表示されていれば、おそらく問題ありません。表示されない場合は、以下のコマンドを編集して手動で追加する必要があるかもしれません。

C:\Users\YourName\AppData\Local\Programs\Python\Python310\

またはPythonがインストールされている場所に移動し、それをシステムの環境変数のPathに追加します。少し面倒ですが、一度設定しておけば、VS Codeは魔法のようにPythonを問題なく検出します。

Visual Studio Code のインストールと構成

次に、VS Codeを公式サイトからダウンロードします。インストーラーを実行し、ライセンスに同意し、インストール先を選択します。そして最も重要なのは、「PATHに追加」というボックスにチェックを入れることです。Windowsは設定を不必要に複雑にするのが大好きだからです。また、ショートカットを素早く作成したい場合は、「デスクトップアイコンを作成」を有効にしてください。インストールが完了したら、VS Codeを開きます。この時点でほぼ使える状態ですが、Pythonを使いこなすにはPython拡張機能をインストールする必要があります。

VS Code に Python 拡張機能を追加する

VS Codeで拡張機能アイコンをクリック（または）し、 PythonCtrl + Shift + Xを検索します。Microsoftの公式拡張機能が役立ちます。「インストール」をクリックします。この拡張機能の有効化に時間がかかったり、有効化後にVS Codeの再起動が必要になる場合があります。不具合があるように見えても心配しないでください。再起動やウィンドウの再読み込み（その場合はウィンドウの再読み込みを選択してください）が必要になる場合があります。Ctrl + Shift + P

PythonがVS Codeで認識されることを確認する

インストールが完了したら、プロジェクトフォルダを開くか、新しいフォルダを作成してください。すると、左下にPythonインタープリターが表示されるはずです。表示されない場合は、 を押しCtrl + Shift + P、「Python: Select Interpreter」と入力してください。インストールしたPythonのバージョンを選択してください。表示されない場合は、PATHを再度確認するか、VS Codeを再起動してみてください。一部のマシンでは、Pythonが最初の試行では表示されないものの、再起動後に魔法のように表示されることがあります。奇妙ですが、これがWindowsの常です。

Pythonコードの記述と実行 — 苦労せずに

次に、プロジェクト フォルダー内に新しいファイル ( .py ) を作成し、次のような簡単なコードを記述します。

# Hello World print("Hello, world!") 

ファイルを保存し、実行ボタン（またはCtrl + F5）を押して実行します。すべてが正しく設定されていれば、統合ターミナルに出力が表示されます。正しく設定されていない場合は、インタープリターの設定を再度確認してください。VS CodeがどのPythonを使用するか判断できない場合、コードが実行されないことがあります。インタープリターを再選択して再試行してください。通常は、再起動または再設定で修正できます。

拡張機能で物事をより良くする

さて、起動したら、生産性を大幅に向上させるために拡張機能をいくつかインストールすることを検討してください。

• Pylance : 高速かつ正確なオートコンプリートと入力サポートのスター。
• Jupyter : ノートブックに興味があるなら、これを使用するとデータ サイエンスの作業が簡単になります。
• autoDocstring : ドキュメント文字列を自動的に生成し、入力作業を大幅に節約します。
• Python テスト エクスプローラー: VS Code を離れずにテストを実行します。

ほぼこれで完了です。これらを設定すれば、Python開発がずっとスムーズになります。ただし、PATHが正しく設定されていない場合や拡張機能がすぐに読み込まれない場合、Windowsが時々クラッシュすることを覚えておいてください。再起動するか、インタープリターを再選択すると、奇妙なバグが修正されることが多いです。

まとめ

• Pythonが「PATHに追加」にチェックを入れてインストールされていることを確認してください
• VS Codeをインストールし、セットアップ中に「PATHに追加」をチェックします
• VS Code内にPython拡張機能をインストールする
• 「Python: インタープリターを選択」から適切なインタープリターを選択します。
• Pythonファイルを作成して実行する

まとめ

PythonとVS Codeをうまく連携させるには、特にWindowsの癖など、多少の試行錯誤が必要になるかもしれません。しかし、一度設定してしまえば、コードの記述と実行ははるかにスムーズになります。Pythonのバージョン、拡張機能、環境が適切に設定されていることを確認してください。それから、環境変数の編集に慣れていない限り、PATHの変更は避けた方が良いでしょう。これで誰かの頭痛の種が少しでも軽減されると良いですね。幸運を祈ります。楽しいコーディングを！

---

---