Python インタープリターのデバッグ シンボルのインストールInstalling debugging symbols for Python interpreters

完全なデバッグ エクスペリエンスを提供するため、Visual Studio の混合モードの Python デバッガーでは、多数の内部データ構造を解析するために、Python インタープリターのデバッグ シンボルを使用する必要があります。To provide a full debugging experience, the mixed-mode Python debugger in Visual Studio needs debug symbols for the Python interpreter being used to parse numerous internal data structures. たとえば、python27.dll の場合、対応するシンボル ファイルは python27.pdb です。python36.dll の場合、シンボル ファイルは python36.pdb です。For python27.dll, for example, the corresponding symbol file is python27.pdb; for python36.dll, the symbol file is python36.pdb. また、各バージョンのインタープリターは、多様なモジュールに合わせてシンボル ファイルを用意しています。Each version of the interpreter also supplies symbol files for a variety of modules.

Visual Studio 2017 の "Python 3" および "Anaconda 3" インタープリターの場合、それぞれのシンボルが自動的にインストールされ、Visual Studio で自動的に検出されます。With Visual Studio 2017, the "Python 3" and "Anaconda 3" interpreters automatically install their respective symbols and Visual Studio find those symbols automatically. Visual Studio 2015 以前の場合、または他のインタープリターを使用している場合は、シンボルを別にダウンロードし、Visual Studio の [デバッグ] > [シンボル] タブの [ツール] > [オプション] でシンボルの場所を設定する必要があります。これらの手順については、以下のセクションで詳しく説明します。For Visual Studio 2015 and earlier, or when using other interpreters, you need to download symbols separately and then point Visual Studio to them through the Tools > Options dialog in the Debugging > Symbols tab. These steps are detailed in the following sections.

Visual Studio でシンボルが必要なとき、通常は混合モードのデバッグ セッションを開始したときに、プロンプトが表示されることがあります。Visual Studio may prompt you when it needs symbols, typically when starting a mixed-mode debugging session. この場合、ダイアログで 2 つの選択肢が示されます。In this case, it displays a dialog with two choices:

  • [シンボル設定ダイアログを開く] を選択すると、[オプション] ダイアログが開き、[デバッグ] > [シンボル] タブが表示されます。Open symbol settings dialog opens the Options dialog to the Debugging > Symbols tab.
  • [インタープリター用のシンボルをダウンロード] を選択すると、この現在のドキュメント ページが開きます。この場合は、[ツール] > [オプション] を選択し、[デバッグ] > [シンボル] タブに移動して続行します。Download symbols for my interpreter opens this present documentation page, in which case, select Tools > Options and navigate to the Debugging > Symbols tab to continue.

    混合モード デバッガーのシンボルのプロンプト

シンボルをダウンロードしていますDownloading symbols

  • Python 3.5 以前: Python インストーラーでデバッグ シンボルを取得します。Python 3.5 and later: acquire debug symbols through the Python installer. [カスタム インストール] を選択し、[次へ] を選択します。[詳細設定] 画面で、[Download debugging symbols] (デバッグ シンボルのダウンロード) と [Download debug binaries] (デバッグ バイナリのダウンロード) を選択します。Select Custom installation, select Next to get to Advanced Options, then select the boxes for Download debugging symbols and Download debug binaries:

    デバッグ シンボルを含む Python 3.x インストーラー

    シンボル ファイル (.pdb) はルート インストール フォルダーに保存されます (個々のモジュールのシンボル ファイルも DLLs フォルダーにあります)。The symbol files (.pdb) are then found in the root installation folder (symbol files for individual modules are in the DLLs folder as well). そのため、シンボル ファイルは Visual Studio で自動的に検出されます。追加の手順は必要ありません。Because of this, Visual Studio finds them automatically, and no further steps are needed.

  • Python 3.4.x 以前: シンボルは、公式のディストリビューションまたは Enthought Canopy から、ダウンロード可能な .zip ファイルとして入手できます。Python 3.4.x and earlier: symbols are available as downloadable .zip files from the official distributions or Enthought Canopy. ダウンロード後は、Python フォルダー内の Symbols などのローカル フォルダーにファイルを展開して続行します。After downloading, extract files to a local folder to continue, such as a Symbols folder within the Python folder.

    重要

    Python のマイナー ビルド間や 32 ビット ビルドと 64 ビット ビルド間でもシンボルは異なるため、バージョンを完全に一致させることをお勧めします。Symbols differ between minor builds of Python, and between 32-bit and 64-bit builds, so you want to exactly match the versions. 使用するインタープリターを確認するには、ソリューション エクスプローラーでプロジェクトの [Python 環境] ノードを展開し、環境名をメモします。To check the interpreter being used, expand the Python Environments node under your project in Solution Explorer and note the environment name. 次に [Python 環境] ウィンドウに切り替え、インストール場所をメモします。Then switch to the Python Environments window and note the install location. 次にコマンド ウィンドウでその場所を開き、python.exe を起動します。正確なバージョンと 32 ビットか 64 ビットかが表示されます。Then open a command window in that location and start python.exe, which displays the exact version and whether it's 32-bit or 64-bit.

  • ActiveState Python などのサードパーティの Python ディストリビューションを使用している場合は、そのディストリビューションの作成者に連絡して、シンボルの提供を依頼する必要があります。For any other third-party Python distribution such as ActiveState Python: contact the authors of that distribution and request them to provide you with symbols. WinPython には、標準の Python インタープリターが変更なしで組み込まれているため、対応するバージョン番号用の公式ディストリビューションのシンボルを使用できます。WinPython, for its part, incorporates the standard Python interpreter without changes, so use symbols from the official distribution for the corresponding version number.

Visual Studio にシンボルの場所を設定するPointing Visual Studio to the symbols

シンボルを別にダウンロードした場合は、以下の手順に従って、Visual Studio にシンボルを認識させます。If you downloaded symbols separately, follow the steps below to make Visual Studio aware of them. Python 3.5 以降のインストーラーでシンボルをインストールした場合、Visual Studio で自動的に検出されます。If you installed symbols through the Python 3.5 or later installer, Visual Studio finds automatically.

  1. [ツール] > [オプション] メニューを選択し、[デバッグ] > [シンボル] を選択します。Select the Tools > Options menu and navigate to Debugging > Symbols.

  2. ツールバーの [追加] ボタン (下図の線で囲まれたボタン) を選択し、ダウンロードしたシンボルを展開したフォルダー (下図のように、c:\python34\Symbols など、python.pdb がある場所) を入力し、[OK] を選択します。Select the Add button on the toolbar (outlined below), enter the folder where you expanded the downloaded symbols (which is where python.pdb is located, such as c:\python34\Symbols, shown below), and select OK.

    混合モードのデバッグでのシンボルのオプション

  3. Visual Studio のデバッグ セッション中に、Python インタープリターのソース ファイルの場所を入力するように求められることもあります。During a debugging session, Visual Studio might also prompt you for the location of a source file for the Python interpreter. ソース ファイルを (python.org/downloads などから) ダウンロードした場合は、その場所を設定することもできます。If you've downloaded source files (from python.org/downloads, for example), then you of course can point to them as well.

注意

ダイアログに表示されているシンボルのキャッシュ機能は、オンライン ソースから取得したシンボルのローカル キャッシュを作成するときに使用します。The symbol caching features shown in the dialog are used to create a local cache of symbols obtained from an online source. Python インタープリターのシンボルの場合、既にローカルに存在するので、これらの機能は必要ありません。These features aren't needed with the Python interpreter symbols as symbols are already present locally. いずれの場合も、詳細については、「Specify Symbols and Source Files in the Visual Studio Debugger」(Visual Studio デバッガーでシンボルとソース ファイルを指定する) を参照してください。In any case, refer to Specify Symbols and Source Files in the Visual Studio Debugger for details.

公式ディストリビューションOfficial distributions

Python のバージョンPython version ダウンロードDownloads
3.5 以降3.5 and later Python インストーラーでシンボルをインストールします。Install symbols through the Python installer.
3.4.43.4.4 32 ビット - 64 ビット32-bit - 64-bit
3.4.33.4.3 32 ビット - 64 ビット32-bit - 64-bit
3.4.23.4.2 32 ビット - 64 ビット32-bit - 64-bit
3.4.13.4.1 32 ビット - 64 ビット32-bit - 64-bit
3.4.03.4.0 32 ビット - 64 ビット32-bit - 64-bit
3.3.53.3.5 32 ビット - 64 ビット32-bit - 64-bit
3.3.43.3.4 32 ビット - 64 ビット32-bit - 64-bit
3.3.33.3.3 32 ビット - 64 ビット32-bit - 64-bit
3.3.23.3.2 32 ビット - 64 ビット32-bit - 64-bit
3.3.13.3.1 32 ビット - 64 ビット32-bit - 64-bit
3.3.03.3.0 32 ビット - 64 ビット32-bit - 64-bit
2.7.112.7.11 32 ビット - 64 ビット32-bit - 64-bit
2.7.102.7.10 32 ビット - 64 ビット32-bit - 64-bit
2.7.92.7.9 32 ビット - 64 ビット32-bit - 64-bit
2.7.82.7.8 32 ビット - 64 ビット32-bit - 64-bit
2.7.72.7.7 32 ビット - 64 ビット32-bit - 64-bit
2.7.62.7.6 32 ビット - 64 ビット32-bit - 64-bit
2.7.52.7.5 32 ビット - 64 ビット32-bit - 64-bit
2.7.42.7.4 32 ビット - 64 ビット32-bit - 64-bit
2.7.32.7.3 32 ビット - 64 ビット32-bit - 64-bit
2.7.22.7.2 32 ビット - 64 ビット32-bit - 64-bit
2.7.12.7.1 32 ビット - 64 ビット32-bit - 64-bit

Enthought CanopyEnthought Canopy

Enthought Canopy は、バージョン 1.2 以降、バイナリのシンボルを提供します。Enthought Canopy provides symbols for its binaries starting from version 1.2. それらはディストリビューションと共に自動的にインストールされますが、それらが格納されたフォルダーをシンボル パスに追加する操作は手動で実行する必要があります。They are automatically installed alongside with the distribution, but you still need to manually add the folder containing them to symbol path as described earlier. Canopy の一般的なユーザーごとのインストールでは、シンボルは、64 ビット版では %UserProfile%\AppData\Local\Enthought\Canopy\User\Scriptsに、32 ビット版では %UserProfile%\AppData\Local\Enthought\Canopy32\User\Scripts に配置されます。For a typical per-user installation of Canopy, the symbols are located in %UserProfile%\AppData\Local\Enthought\Canopy\User\Scripts for the 64-bit version and %UserProfile%\AppData\Local\Enthought\Canopy32\User\Scripts for the 32-bit version.

Enthought Canopy 1.1 以前と Enthought Python Distribution (EPD) はインタープリター シンボルの提供がないため、混合モードのデバッグには対応できません。Enthought Canopy 1.1 and earlier, as well as Enthought Python Distribution (EPD), do not provide interpreter symbols, and are therefore not compatible with mixed-mode debugging.