適用於 Visual Studio 的 Python 工具 中的 Python 環境視窗索引標籤參考

開啟 [Python 環境] 視窗:

  • 選取 [檢視]>[其他視窗]>[Python 環境] 功能表命令。
  • 在 [方案總管] 中,以滑鼠右鍵按一下專案的 [Python 環境] 節點,然後選取 [檢視所有 Python 環境]

如果您將 [Python 環境] 視窗展開至足夠寬度,便會以索引標籤的形式來顯示這些選項,以方便您使用。 為了清楚起見,本文章中的索引標籤會以展開檢視來顯示。

Python Environments window expanded view

索引標籤:概觀

提供環境的基本資訊和命令:

Python Environments overview tab

Command 描述
將此環境設為新專案的預設值 設定使用中環境,可能會導致在載入 IntelliSense 資料庫時,Visual Studio (2017 15.5 版及更早版本) 短暫沒有反應。 環境如果含有許多套件,則無反應的時間可能會更長。
瀏覽散發者的網站 將瀏覽器開啟至 Python 發行所提供的 URL。 例如,Python 3.x 會移至 python.org。
開啟互動式視窗 在 Visual Studio 內開啟此環境的互動式 (REPL) 視窗,並套用任何啟動指令碼 (請參閱下面)
探索互動式指令碼 請參閱啟動指令碼
使用 IPython 互動模式 設定時,預設會開啟 IPython 的互動式視窗。 這會啟用內嵌繪圖和延伸的 IPython 語法,例如 name? 可檢視說明,而 !command 適用於殼層命令。 使用需要額外套件的 Anaconda 發佈時,建議使用此選項。 如需詳細資訊,請參閱在互動式視窗中使用 IPython
在 PowerShell 中開啟 在 PowerShell 命令視窗中啟動解譯器。
(資料夾和程式的連結) 可讓您快速存取環境的安裝資料夾、python.exe 解譯器和 pythonw.exe 解譯器。 第一個會在 Windows 檔案總管中開啟,後面兩個則會開啟主控台視窗。

啟動指令碼

因為您在日常工作流程中使用互動式視窗,所以您可能會開發定期使用的協助程式函式。 例如,您可以建立可在 Excel 中開啟 DataFrame 的函式,然後將該程式碼儲存為啟動指令碼,讓它一律可在互動式視窗中使用。

啟動指令碼包含互動式視窗所載入並自動執行的程式碼,包括匯入、函式定義,以及文字形式的任何其他項目。 這類指令碼是使用兩種方式進行參考:

  1. 當您安裝環境時,Visual Studio 會建立資料夾 Documents\Visual Studio <version>\Python Scripts\<environment>,其中 <version> 是 Visual Studio 版本 (例如 2017 或 2019),而< environment> 會符合環境的名稱。 您可以使用 [探索互動式指令碼] 命令,輕鬆地巡覽至環境特定資料夾。 當您啟動該環境的互動式視窗時,只要依字母順序在這裡找到 .py 檔案,就會載入並執行互動式視窗。

  2. [工具]>[選項]>[Python]>[互動式視窗] 索引標籤中的 [指令碼] 控制項 (請參閱互動式視窗選項) 是用來指定在所有環境中載入和執行之啟動指令碼的其他資料夾。 不過,此功能目前無法使用。

Configure (設定) 索引標籤

如果可用,[設定] 索引標籤就會包含如下表所述的詳細資料。 如果沒有此索引標籤,即表示目前由 Visual Studio 自動管理所有詳細資料。

Python Environments configure tab

欄位 描述
說明 要賦予環境的名稱。
前置詞路徑 解譯器的基底資料夾位置。 填入此值並按一下 [自動偵測] 之後,Visual Studio 就會嘗試為您填入其他欄位。
解譯器路徑 解譯器可執行檔的路徑,通常是前置路徑後面再接著 python.exe
具範圍限制的解譯器 非主控台可執行檔的路徑,通常是前置路徑後面再接著 pythonw.exe
Library path (程式庫路徑)
(如果有的話)
指定標準程式庫的根目錄,但如果 Visual Studio 能夠從解譯器要求更精確的路徑,則可以忽略這個值。
Language version (語言版本) 從下拉式功能表中選取。
架構 通常會自動偵測並填入,否則會指定 [32 位元] 或 [64 位元]
Path environment variable (路徑環境變數) 解譯器用來尋找搜尋路徑的環境變數。 Visual Studio 會在啟動 Python 時變更變數的值,使其包含專案的搜尋路徑。 通常這個屬性應該設定為 PYTHONPATH,但有些解譯器會使用不同的值。

套件索引標籤

在舊版中,也標示為 "pip"。

使用 pip ([套件 (PyPI)] 索引標籤) 或 conda ([套件 (Conda)] 索引標籤,適用於 Visual Studio 2017 15.7 版及更新版本的 Conda 環境) 來管理環境中所安裝的套件。 在此索引標籤中,您也可以搜尋並安裝新的套件,包括其相依性。

已安裝的套件會和更新 (向上箭頭) 及解除安裝 (位於圓圈中的交叉) 該套件的控制項一起顯示:

Python environments packages tab

輸入搜尋詞彙能篩選已安裝的套件,以及可從 PyPI 安裝之套件的清單。

Python environments packages tab with a search on

您可以在上圖中看到,搜尋結果會顯示符合搜尋詞彙的套件數;不過,在清單中的第一個項目,是要直接執行 pip install <名稱> 的命令。 如果您在 [套件 (Conda)] 索引標籤上,您會改為看到 conda install <名稱>

Conda packages tab showing a conda install command

在這兩種情況下,您可以在 [搜尋] 方塊中,在套件名稱之後新增引數來自訂安裝。 包含引數時,搜尋結果會顯示 pip installconda install,後面接著搜尋方塊的內容:

Using arguments on pip and conda install commands

安裝套件時會在環境於檔案系統的 Lib 資料夾內建立子資料夾。 例如,若您在 c:\Python36 中安裝 Python 3.6,套件會安裝在 c:\Python36\Lib 中;若您在 c:\Program Files\Anaconda3 中安裝 Anaconda3,套件會安裝在 c:\Program Files\Anaconda3\Lib。 對於 Conda 環境,套件會安裝於該環境的資料夾中。

授與套件安裝用的系統管理員權限

將套件安裝至位於檔案系統受保護區域的環境時,例如 c:\Program Files\Anaconda3\Lib,Visual Studio 必須提高權限來執行 pip install 以允許它建立套件子資料夾。 需要提高權限時,Visual Studio 會顯示「可能需要系統管理員權限才可安裝、更新或移除此環境的套件」提示:

Elevation prompt for package installation

[立即提高權限] 會將系統管理權限授與 pip 以進行單一作業、主題,也會授與權限的任何作業系統提示。 選取 [在沒有系統管理員權限的情況下繼續] 會嘗試安裝套件,但在嘗試建立包含「錯誤: 無法建立 'C:\Program Files\Anaconda3\Lib\site-packages\png.py': 權限遭拒」這類輸出的資料夾時,pip 會失敗。

選取 [安裝或移除套件時一律提高權限] 可防止在環境有問題時顯示對話方塊。 若要再次顯示對話方塊,請移至 [工具]>[選項]>[Python]>[一般],然後選取 [重設所有永久隱藏的對話方塊] 按鈕。

在這個相同的 [選項] 索引標籤中,您也可以選取 [一律以系統管理員身分執行 pip] 來隱藏所有環境的對話方塊。 請參閱選項 - 一般索引標籤

較舊版本 Python 的安全性限制

使用 Python 2.6、3.1 和 3.2 時,Visual Studio 會顯示警告「由於新的安全性限制,從網際網路安裝可能不適用於此版本的 Python」

Message about pip install restrictions with older version of Python

警告的原因是,使用這些較舊版本的 Python 時,pip install 未包含傳輸安全性層 (TLS) 1.2 的支援,這在從套件來源 pypi.org 下載套件時是必要的。自訂 Python 組建可能會支援 TLS 1.2,在此情況下 pip install 可能有效。

可以從 bootstrap.pypa.io 下載套件的適當 get-pip.py、從 pypi.org 手動下載套件,然後從該本機複本安裝套件。

不過,建議直接升級至最新版 Python,如此便不會出現警告。

另請參閱