こんにちは、かつコーチです。
「エディタにPythonのファイルを書いたのに、実行方法が分からない」という質問をよく受けます。
私も最初は、ターミナルとエディタを別々に開いて、行ったり来たりしていました。
この記事では、無料で使えるエディタVSCodeを使って、Pythonのコードを快適に書き・実行し・デバッグする方法を解説します。
VSCodeとは？
無料で使える高機能コードエディタ
VSCode（Visual Studio Code）とは、Microsoftが提供する無料のコードエディタです。
拡張機能（エディタに機能を追加する追加プログラム）を入れることで、さまざまな言語の開発に対応できます。
Python開発でも定番のエディタとして広く使われており、公式のPython拡張機能も充実しています。
なぜPython拡張機能が必要なのか
VSCodeをインストールしただけでは、Pythonの構文チェックやコード補完は機能しません。
公式の「Python」拡張機能を入れることで、これらの機能が有効になります。
入れずに使い続けると、単純な文法ミスにも気づきにくく、開発効率が大きく下がってしまいます。
VSCodeでPython環境を整える手順
手順1：Python拡張機能をインストールする
VSCodeを起動し、左側のサイドバーから拡張機能アイコンを開きます。
検索欄に「Python」と入力し、Microsoft公式の「Python」拡張機能をインストールします。
あわせて「Pylance」（コード補完を強化する拡張機能）も自動でインストールされることが多いです。
手順2：使用するインタプリタを選択する
インタプリタとは、実際にコードを実行するPython本体のことです。
VSCodeの右下、または画面上部のコマンドパレット（Cmd+Shift+P）から「Python: Select Interpreter」を選びます。
Python: Select Interpreter
一覧の中から、先ほどvenvで作成した仮想環境のPythonを選びます。
選ぶべきパスは、以下のような形式です。
./venv/bin/python
これを選んでおかないと、VSCode上のコード補完や実行が、意図しないPythonを参照してしまいます。
手順3：コードを実行する
Pythonファイルを開いた状態で、右上の再生ボタン（▷）を押すと実行できます。
またはターミナルで、以下のように直接実行することもできます。
python main.py
手順4：デバッグ実行の基本
コードの途中の値を確認したいときは、ブレークポイント（処理を一時停止させる目印）を使います。
コードの行番号の左側をクリックすると、赤い丸がつき、ブレークポイントが設定されます。
その状態でF5キーを押すと、デバッグ実行が始まり、ブレークポイントの位置で処理が止まります。
止まった状態で、変数の中身を画面左側のパネルから確認できます。
よくあるつまずきポイント：インタプリタが反映されない
Before：仮想環境を選んだのにモジュールが見つからないエラー
私がVSCodeを使い始めた頃、venvを作ってpip install requestsもしたのに、こんなエラーが出て困りました。
Traceback (most recent call last):
File "main.py", line 1, in <module>
import requests
ModuleNotFoundError: No module named 'requests'
インタプリタの選択画面では正しいvenvを選んでいたはずなのに、実行時だけシステムのPythonが使われていたことが原因でした。
VSCodeのターミナルは、開いたタイミングによっては仮想環境が有効化されないことがあります。
After：ターミナルを開き直して仮想環境を有効化する
# VSCode内のターミナルで仮想環境を再度有効化
source venv/bin/activate
# プロンプトに(venv)が付いていることを確認してから実行
python main.py
インタプリタを選択した後は、一度ターミナルを閉じて開き直すと、正しく仮想環境が反映されることが多いです。
それでも解決しない場合は、VSCode自体を再起動すると直ることがほとんどです。
まとめ
この記事のポイント
- VSCodeはPython開発で広く使われている無料エディタである
- 公式の「Python」拡張機能を入れることで、補完や構文チェックが有効になる
- 「Python: Select Interpreter」で、必ずプロジェクトのvenvを選択する
- ブレークポイントと
F5キーで、コードの動きを1行ずつ確認できる
次に読むべき記事
これで環境構築の基本は一通り整いました。
次はいよいよPythonの基本文法に入ります。
「変数とデータ型の基本」で、実際にコードを書きながら学んでいきましょう。
タグ: Python, 初心者向け, 環境構築