VS Code での Python クイックスタートガイド
Python 拡張機能を使用することで、Visual Studio Code は優れた Python エディタとなり、あらゆるオペレーティングシステムで動作し、さまざまな Python インタプリタと組み合わせて使用できます。
インストールから始めましょう
- VS Code
- Python インタプリタ (任意のサポート中の Python バージョン)
- VS Code Marketplace から Python 拡張機能
Python 用に VS Code をさらにカスタマイズするには、Python プロファイルテンプレートを活用してください。推奨される拡張機能や設定が自動的にインストールされます。データサイエンスプロジェクトの場合は、データサイエンスプロファイルテンプレートの使用を検討してください。
Python プロジェクトやファイルの作成と開き方
既存の Python プロジェクトを VS Code で作業したい場合は、VS Code のウェルカムページやファイルエクスプローラーからフォルダーまたはファイルを開くか、ファイル > フォルダーを開く (Ctrl+K Ctrl+O)、または ファイル > ファイルを開く (⌘O (Windows, Linux では Ctrl+O)) を選択して開始できます。
新しい Python ファイルを作成するには、VS Code のウェルカムページで 新規ファイル を選択してから Python ファイル を選択するか、ファイル > 新規ファイル () に移動します。
ヒント: すでに VS Code でワークスペースフォルダーを開いている場合は、新しいファイルやフォルダーを既存のプロジェクトに直接追加できます。ファイルエクスプローラービューで最上位のフォルダーにある 新しいフォルダー または 新しいファイル アイコンを使用して、新しいフォルダーやファイルを作成できます。
UI ツアー
初めて VS Code を起動したときは、Python 固有の機能や UI を利用するために Python 拡張機能をインストールする必要があります。Python 拡張機能をインストールした後の UI を見ていきましょう。
コードアクション
コードアクション（クイックフィックスとも呼ばれます）は、コードに警告がある場合に問題を解決するのに役立ちます。これらの便利なヒントは、エディタの左側の余白に電球アイコン (💡) として表示されます。電球を選択すると、コードアクションのオプションが表示されます。これらのコードアクションは、Python、Pylance、または VS Code 自体などの拡張機能から提供されます。コードアクションの詳細については、Python クイックフィックス を参照してください。
Python コマンド
Python コマンドには、コマンドパレット (⇧⌘P (Windows, Linux では Ctrl+Shift+P)) からアクセスできます。コマンドパレットからは、VS Code やインストール済みの拡張機能のさまざまな機能にアクセスできます。コマンドパレットに 「Python: 」 と入力すると、Python 拡張機能で利用可能なコマンドを探すことができます。
実行、デバッグ、テスト
VS Code での Python に慣れてきたところで、コードの実行、デバッグ、テストの方法を学びましょう。
実行
VS Code で Python コードを実行する方法はいくつかあります。
エディタで開いている Python スクリプトを実行するには、エディタの右上にある Python ファイルをターミナルで実行 の再生ボタンを選択します。
VS Code 内で Python コードのスニペットを反復的に実行する他の方法もあります。
- 1 行または複数行を選択し、Shift+Enter を押すか、右クリックして 選択範囲/行を Python ターミナルで実行 を選択します。このコマンドは、ファイルの一部だけをテストする場合に便利です。
- コマンドパレット (⇧⌘P (Windows, Linux では Ctrl+Shift+P)) から、Python: Start REPL コマンドを選択して、現在選択されている Python インタプリタ用の REPL ターミナルを開きます。REPL では、コード行を 1 行ずつ入力して実行できます。
デバッグ
デバッガーは、コード実行の流れを調査し、エラーを特定しやすくするのに役立つツールです。また、プログラムの実行中に変数やデータがどのように変化するかを確認することもできます。検査したい行の横にある溝（ガター）をクリックしてブレークポイントを設定することで、デバッグを開始できます。
デバッグを開始するには、F5 を押してデバッガーを初期化します。このファイルでデバッグを行うのは初めてのため、デバッグするアプリケーションのタイプを選択できる設定メニューが開きます。Python スクリプトの場合は、Python ファイル を選択できます。
プログラムがブレークポイントに到達すると、プログラムは一時停止し、Python デバッグコンソールでデータを追跡したり、デバッグツールバーを使用してプログラムを進めたりできるようになります。
Python のデバッグ機能の詳細については、VS Code での Python デバッグ を参照してください。
テスト
Python 拡張機能は、Unittest および pytest に対する強力なテストサポートを提供します。
アクティビティバーの「テスト」ビューから Python テストを構成 を選択し、目的のテストフレームワークを選択することで、Python テストを構成できます。
また、Python プロジェクトのテストを作成することもできます。選択したフレームワークが構成されると、Python 拡張機能がテストの検出を試みます。Python 拡張機能を使用すると、テストビューでテストの実行とデバッグを行い、テスト結果パネルで実行結果を確認することもできます。
テスト機能の全体像については、VS Code での Python テスト を参照してください。
次のステップ
一般的な Python Web フレームワークを使用して Web アプリを構築する方法については、以下のチュートリアルを参照してください。
- Visual Studio Code で Django を使用する
- Visual Studio Code で Flask を使用する
- Visual Studio Code で FastAPI を使用する
Visual Studio Code には、Python を活用するための機能が他にもたくさんあります。