VS Codeのエージェントモードを拡張するには、を試してください!

VS CodeでのPythonクイックスタートガイド

Python拡張機能により、Visual Studio Codeは優れたPythonエディターとなり、あらゆるオペレーティングシステムで動作し、様々なPythonインタープリターで使用できます。

インストールから始めましょう

Gif installing the Python extension in a fresh install of VS Code

Python用にVS Codeをさらにカスタマイズするには、推奨される拡張機能と設定を自動的にインストールするPythonプロファイルテンプレートを活用できます。データサイエンスプロジェクトには、Data Scienceプロファイルテンプレートの使用を検討してください。

Gif showing the Python profile template being installing into VS Code.

Pythonプロジェクトまたはファイルを作成・開く方法

VS Codeで作業したい既存のPythonプロジェクトがある場合、VS Codeのようこそページまたはファイルエクスプローラービューからフォルダーまたはファイルを開くか、ファイル > フォルダーを開く (Ctrl+K Ctrl+O) または ファイル > ファイルを開く (⌘O (Windows, Linux Ctrl+O)) を選択することで開始できます。

VS Codeのようこそページで新規ファイルを選択し、次にPythonファイルを選択するか、ファイル > 新規ファイル () に移動することで、新しいPythonファイルを作成できます。

ヒント: VS Codeでワークスペースフォルダーが既に開いている場合、既存のプロジェクトに新しいファイルやフォルダーを直接追加できます。ファイルエクスプローラービューの最上位フォルダーにある対応する新規フォルダーまたは新規ファイルアイコンを使用して、新しいフォルダーやファイルを作成できます。

UIツアー

VS Codeを初めて起動する際は、Python固有の機能とUIを利用するためにPython拡張機能をインストールする必要があります。Python拡張機能をインストールした後のUIを見てみましょう

Image of the Python UI highlights in VS Code.

コードアクション

コードに警告がある場合に問題を修正するのに役立つコードアクション(クイックフィックスとも呼ばれます)が提供されます。これらの役立つヒントは、エディターの左余白に電球(💡)として表示されます。電球を選択すると、コードアクションのオプションが表示されます。これらのコードアクションは、Python、Pylance、またはVS Code自体のような拡張機能から提供されます。コードアクションの詳細については、Pythonクイックフィックスを参照してください。

Screenshot showing Code Actions in a Python project.

Pythonコマンド

Pythonコマンドは、コマンドパレット (⇧⌘P (Windows, Linux Ctrl+Shift+P)) を通じてアクセスできます。コマンドパレットからは、VS Codeおよびインストールされた拡張機能の様々な機能にアクセスできます。コマンドパレットに「Python: 」と入力すると、Python拡張機能を通じて利用可能なコマンドを見つけることができます。

Gif demonstrating how to access Python commands in the Command Palette.

実行、デバッグ、テスト

VS CodeでのPythonに慣れてきたところで、コードの実行、デバッグ、テストの方法を学びましょう。

実行

VS CodeでPythonコードを実行するにはいくつかの方法があります。

エディターで開いているPythonスクリプトを実行するには、エディターの右上にあるターミナルでPythonファイルを実行ボタン(再生ボタン)を選択します。

Image showing the Run Python File in Terminal play button.

VS Code内でPythonコードのスニペットを繰り返し実行できる追加の方法もあります

  • 1行以上を選択し、Shift+Enterを押すか、右クリックして選択/行をPythonターミナルで実行を選択します。このコマンドは、ファイルの一部をテストするのに便利です。
  • コマンドパレット (⇧⌘P (Windows, Linux Ctrl+Shift+P)) から、Python: REPLを開始コマンドを選択すると、現在選択されているPythonインタープリター用のREPLターミナルが開きます。REPLでは、一度に1行ずつコードを入力して実行できます。

デバッグ

デバッガーは、コード実行の流れを検査し、エラーをより簡単に特定できるほか、プログラムの実行中に変数やデータがどのように変化するかを探索できる便利なツールです。検査したい行の隣にあるガターをクリックして、Pythonプロジェクトにブレークポイントを設定することでデバッグを開始できます。

Screenshot showing a debugger breakpoint in a Python program.

デバッグを開始するには、F5を押してデバッガーを初期化します。このファイルをデバッグするのが初めての場合、デバッグしたいアプリケーションの種類を選択できる設定メニューが開きます。Pythonスクリプトであれば、Pythonファイルを選択できます。

プログラムがブレークポイントに到達すると、停止し、Pythonデバッグコンソールでデータを追跡したり、デバッグツールバーを使用してプログラムを進めたりすることができます。

Gif showing how to configure the Python debugger for the first time.

Pythonデバッグ機能の詳細については、VS CodeでのPythonデバッグを参照してください。

テスト

Python拡張機能は、Unittestおよびpytestの堅牢なテストサポートを提供します。

アクティビティバーの「テスト」ビューでPythonテストを構成を選択し、お好みのテストフレームワークを選択することで、Pythonテストを構成できます。

Pythonプロジェクトのテストを作成することもできます。選択したフレームワークが構成されると、Python拡張機能がそれらを発見しようとします。また、Python拡張機能を使用すると、「テスト」ビューでテストを実行およびデバッグし、テスト実行結果を「テスト結果」パネルで検査できます。

Gif demonstrating test configuration, discovery, and run in the Python extension.

テスト機能の包括的な内容については、VS CodeでのPythonテストを参照してください。

次のステップ

人気のPython Webフレームワークを使用してWebアプリを構築する方法を学ぶには、以下のチュートリアルを参照してください

Visual Studio CodeのPythonにはさらに多くの探索すべきことがあります

  • Pythonプロファイルテンプレート - 厳選された拡張機能、設定、スニペットを含む新しいプロファイルを作成する
  • コードの編集 - Pythonのオートコンプリート、IntelliSense、書式設定、リファクタリングについて学びます。
  • Linting - 様々なPythonリンターを有効にし、構成し、適用します。
  • デバッグ - Pythonをローカルおよびリモートでデバッグする方法を学びます。
  • テスト - テスト環境を構成し、テストを発見、実行、デバッグします。
  • 設定リファレンス - VS CodeのPython関連設定の全範囲を探索します。