Windows に Visual Studio の Python サポートをインストールする方法How to install Python support in Visual Studio on Windows

Visual Studio 用の Python サポート (Python Tools for Visual Studio (PTVS) とも言われます) をインストールするには、使用している Visual Studio のバージョンと一致するセクションの手順を実行します。To install Python support for Visual Studio (also known as Python Tools for Visual Studio or PTVS), follow the instructions in the section that matches your version of Visual Studio:

インストール手順に従った後、Python サポートを簡単にテストするには、Python の対話型ウィンドウを開きます。その場合、Alt + I キーを押して「2+2」と入力します。To quickly test Python support after following the installation steps, open the Python Interactive window by pressing Alt+I and entering 2+2. 4 という出力が表示されない場合は、手順を再確認してください。If you don't see the output of 4, recheck your steps.

Tip

Python ワークロードには、テンプレートの検出、テンプレート オプションの入力、およびプロジェクトとファイルの作成を行うためのグラフィカル ユーザー インターフェイスを提供する、有用な Cookiecutter 拡張機能が含まれています。The Python workload includes the helpful Cookiecutter extension that provides a graphical user interface to discover templates, input template options, and create projects and files. 詳細については、「Cookiecutter 拡張機能の使用」を参照してください。For details, see Use Cookiecutter.

Note

現在、Python のサポートは Visual Studio for Mac では使用できませんが、Visual Studio Code によって Mac と Linux でも使うことができます。Python support is not presently available in Visual Studio for Mac, but is available on Mac and Linux through Visual Studio Code. questions and answers (質問と回答)」をご覧ください。See questions and answers.

Visual Studio 2017 と Visual Studio 2019Visual Studio 2019 and Visual Studio 2017

  1. 最新の Visual Studio インストーラーをダウンロードし、実行します。Download and run the latest Visual Studio installer. Visual Studio が既にインストールされている場合は、Visual Studio インストーラーを実行し、[変更] オプションを選択して (Visual Studio の変更に関するページをご覧ください)、手順 2 へ進みます。If you have Visual Studio installed already, run the Visual Studio Installer, select the Modify option (see Modify Visual Studio) and go to step 2.

    Tip

    このコミュニティ版は、個人の開発者、クラス学習、学術研究、オープン ソース開発向けです。The Community edition is for individual developers, classroom learning, academic research, and open source development. その他の用途には、Visual Studio 2019 Professional または Visual Studio 2019 Enterprise を使用してください。For other uses, install Visual Studio 2019 Professional or Visual Studio 2019 Enterprise.

  2. インストーラーによって、ワークロード一覧が表示されます。これは、特定の開発分野の関連オプションのグループです。The installer presents you with a list of workloads, which are groups of related options for specific development areas. Python の場合、[Python 開発] ワークロードを選択します。For Python, select the Python development workload.

    Visual Studio インストーラーの [Python 開発] ワークロード

    省略可能: データ サイエンスを扱っている場合、[データ サイエンスと分析のアプリケーション] ワークロードも検討してください。Optional: if you're working with data science, also consider the Data science and analytical applications workload. このワークロードには、Python、R、F# の各言語のサポートが含まれています。This workload includes support for the Python, R, and F# languages. 詳細については、「データ サイエンスと分析のアプリケーション」を参照してください。For more information, see Data science and analytical applications workload.

    Note

    Python とデータ サイエンスのワークロードは、Visual Studio 2017 バージョン 15.2 以降でのみ利用可能です。The Python and Data Science workloads are available only with Visual Studio 2017 version 15.2 and later.

    省略可能: データ サイエンスを扱っている場合、[データ サイエンスと分析のアプリケーション] ワークロードも検討してください。Optional: if you're working with data science, also consider the Data science and analytical applications workload. このワークロードには、Python 言語と F# 言語のサポートが含まれています。This workload includes support for the Python and F# languages. 詳細については、「データ サイエンスと分析のアプリケーション」を参照してください。For more information, see Data science and analytical applications workload.

  3. インストーラーの右側から、必要に応じて追加のオプションを選択します。On the right side of the installer, chose additional options if desired. 既定のオプションを使用する場合は、この手順を省略します。Skip this step to accept the default options.

    Visual Studio インストーラーの [Python 開発] のオプション

    Visual Studio 2019 インストーラーの [Python 開発] のオプション

    オプションOption 説明Description
    Python ディストリビューションPython distributions 使用する予定の Python 2、Python 3、Miniconda、Anaconda2、Anaconda3 ディストリビューションの 32 ビットおよび 64 ビットのバリアントなど、使用可能なオプションの任意の組み合わせを選択します。Choose any combination of the available options, such as 32-bit and 64-bit variants of the Python 2, Python 3, Miniconda, Anaconda2, and Anaconda3 distributions that you plan to work with. それぞれには、ディストリビューションのインタープリター、ランタイム、およびライブラリが含まれます。Each includes the distribution's interpreter, runtime, and libraries. Anaconda とは、具体的には、さまざまな事前インストール パッケージを含むオープンなデータ サイエンス プラットフォームです。Anaconda, specifically, is an open data science platform that includes a wide range of pre-installed packages. (ディストリビューションを追加または削除する場合には、Visual Studio インストーラーへはいつでも戻ることができます。):Visual Studio インストーラー以外で配布をインストールした場合、ここで対応するオプションを確認する必要はありません。(You can return to the Visual Studio installer at any time to add or remove distributions.) Note: If you've installed a distribution outside of the Visual Studio installer, there's no need to check the equivalent option here. Visual Studio は、既存の Python インストールを自動的に検出します。Visual Studio automatically detects existing Python installations. [Python 環境] ウィンドウ」を参照してください。See The Python Environments window. また、インストーラーに表示されているものよりも新しいバージョンの Python を利用できる場合は、そのバージョンを個別にインストールすれば Visual Studio によって検出されます。Also, if a newer version of Python is available than what's shown in the installer, you can install that version separately and Visual Studio will detect it.
    Cookiecutter テンプレートのサポートCookiecutter template support テンプレートの検出、テンプレート オプションの入力、プロジェクトとファイルの作成を行うための Cookiecutter グラフィカル UI をインストールできます。Installs the Cookiecutter graphical UI to discover templates, input template options, and create projects and files. Cookiecutter 拡張機能の使用」を参照してください。See Use the Cookiecutter extension.
    Python Web サポートPython web support HTML、CSS、および JavaScript の編集をサポートする Web 開発用ツールを、Bottle、Flask、および Django フレームワークを使用するプロジェクトのテンプレートと共にインストールします。Installs tools for web development including HTML, CSS, and JavaScript editing support, along with templates for projects using the Bottle, Flask, and Django frameworks. Python Web プロジェクト テンプレート」を参照してください。See Python web project templates.
    Python IoT サポートPython IoT support Python を使用した、Windows IoT Core 開発がサポートされます。Supports Windows IoT Core development using Python.
    Python ネイティブ開発ツールPython native development tools Python のネイティブ拡張機能の開発するために必要な C++ コンパイラおよびその他のコンポーネントがインストールされます。Installs the C++ compiler and other necessary components to develop native extensions for Python. Python 用 C++ 拡張機能の作成」を参照してください。See Create a C++ extension for Python. C++ を完全にサポートするには、C++ によるデスクトップ開発ワークロードもインストールします。Also install the Desktop development with C++ workload for full C++ support.
    Azure Cloud Services コア ツールAzure Cloud Services core tools Python での Azure Cloud Services で開発者に追加のサポートを提供します。Provides additional support for developer Azure Cloud Services in Python. Azure クラウド サービス プロジェクト」を参照してください。See Azure cloud service projects.
  4. インストール後、Visual Studio を変更、起動、修復またはアンインストールするオプションが提供されます。After installation, the installer provides options to modify, launch, repair, or uninstall Visual Studio. Visual Studio への更新プログラムがインストールされているすべてのコンポーネントに利用可能になると、[変更] ボタンが [更新] に変わります。The Modify button changes to Update when updates to Visual Studio are available for any installed components. (その後、[変更] オプションは、ドロップダウン メニューから利用可能になります)。Windows の [スタート] メニューで "Visual Studio" を検索して、Visual Studio とインストーラーを起動することも可能です。(The Modify option is then available on the drop-down menu.) You can also launch Visual Studio and the installer from the Windows Start menu by searching on "Visual Studio".

    インストーラーからの Visual Studio の起動、変更、またはアンインストール

トラブルシューティングTroubleshooting

Visual Studio で Python をインストールしたか、実行したときに問題が発生した場合、次をお試しください。If you encounter problems installing or running Python in Visual Studio, try the following:

  • Python CLI を利用し、つまり、コマンド プロンプトから python.exe を実行し、同じエラーが発生するかどうかを判断します。Determine whether the same error occurs using the Python CLI, that is, running python.exe from a command prompt.
  • Visual Studio インストーラーの [修復] オプションを使用します。Use the Repair option in the Visual Studio installer.
  • Windows で [設定] > [アプリと機能] の順に選択し、Python を修復するか、再インストールします。Repair or reinstall Python through Settings > Apps & features in Windows.

エラー例:対話型プロセスを開始できなかった:System.ComponentModel.Win32Exception (0x80004005):Microsoft.PythonTools.Repl.PythonInteractiveEvaluator.d__43.MoveNext() で原因不明のエラー (0xc0000135)。Example error: Failed to start interactive process: System.ComponentModel.Win32Exception (0x80004005): Unknown error (0xc0000135) at Microsoft.PythonTools.Repl.PythonInteractiveEvaluator.d__43.MoveNext().

Visual Studio 2015Visual Studio 2015

  1. [コントロール パネル] の [プログラムと機能] から Visual Studio インストーラーを実行し、[Microsoft Visual Studio 2015] を選択した後、[変更] を選択します。Run the Visual Studio installer through Control Panel > Programs and Features, selecting Microsoft Visual Studio 2015 and then Change.

  2. インストーラーで、[変更] を選択します。In the installer, select Modify.

  3. [プログラミング言語] > [Python Tools for Visual Studio] の順に選択し、[次へ] を選択します。Select Programming Languages > Python Tools for Visual Studio and then Next:

    Visual Studio 2015 インストーラーの PTVS オプション

  4. Visual Studio のセットアップが完了したら、任意の Python インタープリターをインストールしますOnce Visual Studio setup is complete, install a Python interpreter of your choice. Visual Studio 2015 がサポートしているのは Python 3.5 およびそれ以前のバージョンのみです。それ以降のバージョンでは、「Python バージョン 3.6 はサポートされていません」などのようなメッセージが表示されます。Visual Studio 2015 supports only Python 3.5 and earlier; later versions generate a message like Unsupported Python version 3.6). インタープリターは既にインストールされているが、Visual Studio によって自動的に検出されない場合は、「既存の環境を手動で識別する」を参照してください。If you already have an interpreter installed and Visual Studio doesn't detect it automatically, see Manually identify an existing environment.

Visual Studio 2013 以前Visual Studio 2013 and earlier

  1. 使用している Visual Studio のバージョンに適した Python Tools for Visual Studio のバージョンをインストールします。Install the appropriate version of Python Tools for Visual Studio for your version of Visual Studio:

  2. 任意の Python インタープリターをインストールしますInstall a Python interpreter of your choice. インタープリターは既にインストールされているが、Visual Studio によって自動的に検出されない場合は、「既存の環境を手動で識別する」を参照してください。If you already have an interpreter installed and Visual Studio doesn't detect it automatically, see Manually identify an existing environment.

インストールする場所Install locations

既定では、Python サポートは、コンピューター上のすべてのユーザーに対してインストールされます。By default, Python support is installed for all users on a computer.

Visual Studio 2019 と Visual Studio 2017 では、Python ワークロードは %ProgramFiles(x86)%\Microsoft Visual Studio\<VS_version>\<VS_edition>Common7\IDE\Extensions\Microsoft\Python にインストールされます。<VS_version> は 2019 または 2017、<VS_edition> は Community、Professional、または Enterprise です。For Visual Studio 2019 and Visual Studio 2017, the Python workload is installed in %ProgramFiles(x86)%\Microsoft Visual Studio\<VS_version>\<VS_edition>Common7\IDE\Extensions\Microsoft\Python where <VS_version> is 2019 or 2017 and <VS_edition> is Community, Professional, or Enterprise.

Visual Studio 2015 以前のインストール パスを次に示します。For Visual Studio 2015 and earlier, installation paths are as follows:

  • 32 ビット:32-bit:
    • パス: %Program Files(x86)%\Microsoft Visual Studio <VS_ver>\Common7\IDE\Extensions\Microsoft\Python Tools for Visual Studio\<PTVS_ver>Path: %Program Files(x86)%\Microsoft Visual Studio <VS_ver>\Common7\IDE\Extensions\Microsoft\Python Tools for Visual Studio\<PTVS_ver>
    • パスのレジストリの場所:HKEY_LOCAL_MACHINE\Software\Microsoft\PythonTools\<VS_ver>\InstallDirRegistry location of path: HKEY_LOCAL_MACHINE\Software\Microsoft\PythonTools\<VS_ver>\InstallDir
  • 64 ビット:64-bit:
    • パス: %Program Files%\Microsoft Visual Studio <VS_ver>\Common7\IDE\Extensions\Microsoft\Python Tools for Visual Studio\<PTVS_ver>Path: %Program Files%\Microsoft Visual Studio <VS_ver>\Common7\IDE\Extensions\Microsoft\Python Tools for Visual Studio\<PTVS_ver>
    • パスのレジストリの場所:HKEY_LOCAL_MACHINE\Software\Wow6432Node\Microsoft\PythonTools\<VS_ver>\InstallDirRegistry location of path: HKEY_LOCAL_MACHINE\Software\Wow6432Node\Microsoft\PythonTools\<VS_ver>\InstallDir

それぞれの文字について以下に説明します。where:

  • <VS_ver> は、次のようになります。<VS_ver> is:
    • Visual Studio 2015 では 14.014.0 for Visual Studio 2015
    • Visual Studio 2013 では 12.012.0 for Visual Studio 2013
    • Visual Studio 2012 では 11.011.0 for Visual Studio 2012
    • Visual Studio 2010 では 10.010.0 for Visual Studio 2010
  • <PTVS_ver> はバージョン番号です (2.2、2.1、2.0、1.5、1.1、1.0 など)。<PTVS_ver> is a version number, such as 2.2, 2.1, 2.0, 1.5, 1.1, or 1.0.

ユーザー固有のインストール (1.5 以前)User-specific installations (1.5 and earlier)

Python Tools for Visual Studio 1.5 以前では、インストールは現在のユーザーのみに許可されます。この場合、インストール パスは %LocalAppData%\Microsoft\VisualStudio\<VS_ver>\Extensions\Microsoft\Python Tools for Visual Studio\<PTVS_ver> になります。この <VS_ver> と <PTVS_ver> は、上記で説明したものと同じです。Python Tools for Visual Studio 1.5 and earlier allowed installation for the current user only, in which case the installation path is %LocalAppData%\Microsoft\VisualStudio\<VS_ver>\Extensions\Microsoft\Python Tools for Visual Studio\<PTVS_ver> where <VS_ver> and <PTVS_ver> are the same as described above.