Python インタープリターのインストール

Visual Studio で使用するための Python インタープリターをインストールするには、いくつかのオプションがあります。 Python ワークロードをインストールするときにインタープリターをインストールすることも、ワークロードが存在する場合にインタープリターをインストールすることもできます。 インタープリターは、Visual Studio インストーラーを使用せずに手動でインストールすることもできます。

既定では、Visual Studio 2017 以降に Python 開発ワークロードをインストールすると、Python 3 (64 ビット) もインストールされます。 オプションとして、32 ビットまたは 64 ビット バージョンの Python 2 または Python 3 と共に、Miniconda (Visual Studio 2019) または Anaconda 2/Anaconda 3 (Visual Studio 2017) をインストールすることもできます。 この種類のインストールの手順については、「Visual Studio での Python サポートのインストール」を参照してください。

別の方法として、Visual Studio の [環境の追加] 機能を使用して、標準の Python インタープリターをインストールすることもできます。 このオプションは、[Python 環境] ウィンドウと [Python] ツールバーで使用できます。

Python インタープリターは、Visual Studio インストーラーを使用せずに手動でインストールすることもできます。 Visual Studio をインストールする前に Anaconda 3 をインストールするとします。 Visual Studio インストーラーを使用して Anaconda を再インストールする必要はありません。 Visual Studio インストーラーにまだ表示されていない新しいバージョンのインタープリターをインストールすることもできます。

前提条件

  • Visual Studio では、Python バージョン 3.7 がサポートされています。 以前のバージョンの Visual Studio を使用して、以前のバージョンの Python で記述されたコードを編集することは可能ですが、これらのバージョンの Python は公式にはサポートされていません。 IntelliSense やデバッグなどの Visual Studio 機能は、以前のバージョンの Python では動作しない可能性があります。

  • Visual Studio 2015 以前の場合は、Python 3.5 以前を使用します。 いずれかの Python インタープリターを手動でインストールする必要があります。

Anaconda ディストリビューション

Visual Studio からは Anaconda ディストリビューションをインストールすることが提案されますが、Anaconda リポジトリのディストリビューションおよび他のパッケージの使用は、Anaconda のサービス使用条件によって制限されています。 これらの条件により、一部の組織では商用ライセンスの料金を Anaconda に支払ったり、別のリポジトリにアクセスするようにツールを構成したりすることが必要になる場合があります。 詳細については、Conda チャネルに関するドキュメントを参照してください。

Python インタープリターを確認する

次の表に、Visual Studio で使用できる Python インタープリターを示します。

インタープリター 説明 メモ
CPython "ネイティブ" で最もよく使われるインタープリターであり、32 ビットと 64 ビットのバージョンがあります (32 ビットを推奨)。 最新の言語機能、Python パッケージの最大限の互換性、完全なデバッグ サポート、および IPython との相互運用性が含まれています。 インストールする Python のバージョンを判断するには、「Python 2 と Python 3 のどちらを使うか」の考慮事項を確認してください。 Visual Studio 2015 以前では、Python 3.6 以降がサポートされていないため、"Python バージョン 3.6 はサポートされていません" のようなエラーが発生する場合があります。 Visual Studio 2015 以前の場合は、Python 3.5 以前を使用します。
IronPython Python の .NET の実装であり、32 ビット バージョンと 64 ビット バージョンがあります。 C#/F#/Visual Basic の相互運用機能、.NET API へのアクセス、標準 Python デバッグ (ただし、C++ 混合モードのデバッグはありません)、IronPython/C# の混合デバッグが提供されます。 IronPython は仮想環境をサポートしていません。
Anaconda Python を利用するオープン データ サイエンス プラットフォーム。 最新バージョンの CPython と、インストールが困難なパッケージのほとんどが含まれています。 インタープリターを決定できない場合は、Anaconda を使用することをお勧めします。
PyPy Python の高パフォーマンスなトレースの JIT 実装。 実行時間の長いプログラムや、パフォーマンスに問題があるが他の解決策が見つからない場合に適しています。 Visual Studio で動作しますが、高度なデバッグ機能のサポートには制限があります。
Jython Java 仮想マシン (JVM) での Python の実装です。 IronPython に似ていますが、Jython で実行されているコードから Java クラスとライブラリを操作できます。 しかし、CPython 用のライブラリの多くにはアクセスできない可能性があります。 Visual Studio で動作しますが、高度なデバッグ機能のサポートには制限があります。

環境を検出する

Visual Studio の [Python 環境] ウィンドウには、既知の環境がすべて表示されます。 既存のインタープリターの更新プログラムが自動的に検出されます。

Visual Studio でインストール済みの環境が検出されない場合は、「既存の環境を手動で識別する」を参照してください。

Python 環境用に新しい検出形式を提供する場合は、「PTVS 環境の検出」(github.com) を参照してください。

レジストリ エントリ

Visual Studio (すべてのバージョン) でレジストリ (「PEP 514 - Python registration in the Windows registry」(PEP 514 - Windows レジストリでの Python の登録) に従って) が確認され、インストールされている各 Python インタープリターとその環境が自動的に検出されます。 Python のインストールは、通常、HKEY_LOCAL_MACHINE\SOFTWARE\Python (32 ビット) および HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Python (64 ビット) キー以下の、PythonCore (CPython) や ContinuumAnalytics (Anaconda) などの配布用ノード内にあります。

インタープリターを移動する

ファイル システムを使用して既存のインタープリターを新しい場所に移動すると、Visual Studio は変更を自動的に検出しません。

  • 元々 [Python 環境] ウィンドウでインタープリターの場所を指定している場合は、そのウィンドウの [構成] タブを使用して環境を編集して新しい場所を特定することができます。 詳細については、「既存の環境を手動で識別する」を参照してください。

  • インストーラー プログラムを使用してインタープリターをインストールした場合は、次の手順でインタープリターを新しい場所に再インストールします。

    1. Python インタープリターを元の場所に復元します。
    2. インストーラーを使用してインタープリターをアンインストールします。これで、レジストリ エントリがクリアされます。
    3. 新しい場所にインタープリターを再インストールします。
    4. Visual Studio を再起動します。これで、古い場所ではなく新しい場所が自動的に検出されます。

このプロセスにより、Visual Studio が使用するインタープリターの場所を特定するレジストリ エントリが正しく更新されます。 インストーラーを使用すると、他にも存在する可能性のある副作用も処理されます。