チュートリアル: Visual Studio での Python の使用

適用対象:yesVisual Studio noVisual Studio for Mac noVisual Studio Code

Python は、信頼性と柔軟性に優れ、簡単に学ぶことができ、すべてのオペレーティング システムで自由に使える一般的なプログラミング言語です。 Python は、強力な開発者コミュニティと多くの無料ライブラリによってサポートされています。 この言語では、Web アプリケーション、Web サービス、デスクトップ アプリ、スクリプト、科学計算など、あらゆる種類の開発がサポートされています。 Python は、多くの大学、科学者、一般の開発者、プロの開発者によって使用されています。

Visual Studio は、Python 言語の最上のサポートを提供しています。 このチュートリアルに従って操作すると、以下の作業を実行できます。

前提条件

  • Python のワークロードがインストールされた Visual Studio 2019。 手順については、「Visual Studio での Python の使用」の「手順 0」をご覧ください。
  • Python のワークロードがインストールされた Visual Studio 2022。 手順については、「Visual Studio での Python の使用」の「手順 0」をご覧ください。

Python Tools for Visual Studio がインストールされている Visual Studio の以前のバージョンを使用することもできます。 「Visual Studio での Python サポートのインストール」をご覧ください。

手順 1: 新しい Python プロジェクトの作成

"プロジェクト" とは、1 つのアプリケーションを生成する、1 つのまとまりとなるすべてのファイルの、Visual Studio での管理方法です。 アプリケーション ファイルには、ソース コード、リソース、および構成が含まれます。 プロジェクトにより、プロジェクトのすべてのファイル間の関係が形式化され、維持されます。 複数のプロジェクト間で共有される外部リソースも、プロジェクトによって管理されます。 プロジェクトを使用すると、アプリケーションを楽に拡張し大きくすることができます。 計画外のフォルダー、スクリプト、テキスト ファイル、ユーザーの頭の中にある関係を手作業で管理するより、プロジェクトを使用する方がはるかに簡単です。

このチュートリアルでは、簡単な空のコード ファイルを含むプロジェクトから開始します。

  1. Visual Studio で [ファイル]>[新規]>[プロジェクト] (Ctrl+Shift+N) を選択し、 [新しいプロジェクト] ダイアログを開きます。 ここでは、さまざまな言語のテンプレートを参照して、プロジェクト用に 1 つ選択して、Visual Studio がそのファイルをどこに配置するか指定します。

  2. Python テンプレートを参照するには、左側で [インストール済み]>[Python] の順に選択するか、"Python" を検索します。 言語のツリー内の場所が思い出せない場合、検索はテンプレートを探す優れた方法です。

    Screenshot showing the Create a new project dialog box with Python project templates.

    Visual Studio での Python のサポートには、Bottle、Flask、Django フレームワークを使用する Web アプリケーションなど、複数のプロジェクト テンプレートが含まれます。 ただし、このチュートリアルでは、空のプロジェクトを作成することから始めます。

  3. [Python アプリケーション] テンプレートを選択し、プロジェクト名を指定して、[OK] を選択します。

  4. しばらくすると、ソリューション エクスプローラー ウィンドウ (1) にプロジェクトの構造が表示されます。 既定のコード ファイルが、エディター (2) で開きます。 ソリューション エクスプローラーで選択された項目の追加情報を表示する、 [プロパティ] ウィンドウ (3) も表示されます。ディスク上の正確な場所も表示されます。

    Screenshot showing the new project open in Visual Studio.

  5. プロジェクトのファイルとフォルダーを参照するためのソリューション エクスプローラーに、少し時間を割いて慣れてください。

    Screenshot of Solution Explorer expanded to show features.

    (1) [新しいプロジェクト] ダイアログ ボックスに指定した名前が使用され、太字で強調表示されているのがあなたのプロジェクトです。 ディスク上では、このプロジェクトは、プロジェクト フォルダーの .pyproj ファイルに該当します。

    (2) 最上位レベルにあるのは、ソリューションです。既定では、名前はプロジェクトと同じです。 ディスク上の .sln ファイルで表されるソリューションは、1 つ以上の関連プロジェクトのコンテナーです。 たとえば、Python アプリケーション用に C++ の拡張機能を記述した場合、その C++ プロジェクトを同じソリューション内に置くことができます。 ソリューションには、専用のテスト プログラム用のプロジェクトと共に、Web サービス用のプロジェクトも含まれる可能性があります。

    (3) プロジェクトの下には、ソース ファイルがあります。この場合は、.py ファイルが 1 つだけあります。 ファイルを選択すると、 [プロパティ] ウィンドウにそのプロパティが表示されます。 ファイルをダブルクリックすると、そのファイルに適した方法でファイルが開きます。

    (4) プロジェクトの下には、[Python の環境] ノードもあります。 これを展開すると、使用可能な Python インタープリターが表示されます。 インタープリター ノードを展開し、その環境 (5) にインストールされているライブラリを参照してください。

    ソリューション エクスプローラーで、いずれかのノードまたは項目を右クリックすると、適切なコマンドのメニューを表示できます。 たとえば、 [名前の変更] コマンドを使用すると、プロジェクトとソリューションを含む、任意のノードまたは項目の名前を変更できます。

  1. Visual Studio で、 [ファイル]>[新規作成]>[プロジェクト] を選択するか、Ctrl+Shift+N キーを押します。 [新しいプロジェクトの作成] 画面が表示され、そこではさまざまな言語でテンプレートを検索して参照できます。

  2. Python テンプレートを表示するには、python を検索します。 言語のツリー内の場所が思い出せない場合、検索はテンプレートを探す優れた方法です。

    Screenshot showing the Create a new project dialog box with Python project templates.

    Visual Studio での Python のサポートには、Bottle、Flask、Django フレームワークの Web アプリケーションなど、複数のプロジェクト テンプレートが含まれます。 このチュートリアルでは、空のプロジェクトから始めます。

  3. PythonConsoleApp テンプレートを選択して、 [次へ] を選択します。

  4. [新しいプロジェクトの構成] 画面で、プロジェクトの名前とファイルの場所を指定してから、 [作成] を選択します。

    Visual Studio で新しいプロジェクトが開きます。

    • Visual Studio の [ソリューション エクスプローラー] ウィンドウに、プロジェクトの構造が表示されます (1)
    • 既定のコード ファイルがエディターで開かれます (2)
    • [プロパティ] ウィンドウに、ディスク上での正確な場所など、ソリューション エクスプローラーで選択されている項目についての情報がさらに表示されます (3)

    Screenshot showing the new project open in Visual Studio.

  5. プロジェクトのファイルとフォルダーを参照できるソリューション エクスプローラーに慣れてください。

    Screenshot of Solution Explorer expanded to show features.

    • 最上位レベルは "ソリューション" で、既定ではプロジェクトと同じ名前です (1)

      ディスク上の .sln ファイルで表されるソリューションは、1 つ以上の関連プロジェクトのコンテナーです。 たとえば、Python アプリケーション用に C++ の拡張機能を記述した場合、その C++ プロジェクトを同じソリューション内に置くことができます。 ソリューションには、Web サービス用のプロジェクトと、専用のテスト プログラム用のプロジェクトも含まれる場合があります。

    • [新しいプロジェクトの作成] ダイアログ ボックスで指定した名前のプロジェクトが、太字で表示されます (2) 。 ディスク上では、プロジェクトはプロジェクト フォルダー内の .njsproj ファイルです。

    • プロジェクトの下には、ソース ファイルがあります。この例では、1 つの .py ファイルだけです (3) 。 ファイルを選択すると、 [プロパティ] ウィンドウにそのプロパティが表示されます。 ファイルをダブルクリックすると、そのファイルに適した方法でファイルが開きます。

    • プロジェクトの下には、 [Python の環境] ノードもあります (4) 。 ノードを展開すると、使用できる Python インタープリターが表示されます。

    • インタープリター ノードを展開すると、その環境にインストールされているライブラリが表示されます (5)

    ソリューション エクスプローラーでノードまたは項目を右クリックすると、適切なコマンドのコンテキスト メニューが表示されます。 たとえば、 [名前の変更] を使用すると、プロジェクトやソリューションなど、ノードまたは項目の名前を変更できます。

次のステップ

詳しい説明