Visual Studio 中 Python 的選項

Visual Studio 提供對設定 Python 開發的互動式開發環境 (IDE) 的支援。 您可以根據喜好設定來設定選項，以符合特定的開發環境需求。 本文描述適用於一般配置和行為、偵錯、診斷和進階 Python 語言功能的選項。

Python 選項的位置

Python 組態設定可從 [工具]>[選項] 下的 Visual Studio 工具列取得。 [選項] 對話方塊會列出 Python 索引標籤上 Python 的大部分設定：

您可以設定偵錯、Pylance 語言伺服器分析、Conda 環境、一般環境和 [互動視窗] 的喜好設定。

[選項] 對話方塊會列出 [文字編輯器>[Python] 底下的其他 Python 設定。 具有捲軸、索引標籤和格式設定的選項，以及一般和進階設定。 [文字編輯器] 設定群組的 [環境]>[字型和色彩] 底下提供了其他設定。

注意

[選項] 對話方塊可能包含一個 [實驗性]索引標籤或群組，用於顯示本文中未描述的正在開發的功能。 您可以在 Microsoft 部落格的 Python 工程文章中找到詳細資訊。

Python 的特定選項

在 [工具]>[選項]>[Python] 下，您可以設定一般環境的 Python 特定選項，包括 [互動視窗]、Conda 環境、偵錯等。

一般 Python 選項

[工具]>[選項]>[Python]>[一般] 底下提供了下列選項：

選項	預設	描述
建立虛擬環境時顯示輸出視窗	另一	清除即可防止 [輸出] 視窗出現。
安裝或移除套件時顯示輸出視窗	另一	清除即可防止 [輸出] 視窗出現。
顯示建立環境的通知列	另一	當設定且開啟具有 requirements.txt 或 environment.yml 檔案的專案時，Visual Studio 會顯示資訊列，其中包含個別建立虛擬環境或 Conda 環境，而不是使用預設全域環境的建議。
顯示安裝套件的通知列	另一	當設定且開啟具有 requirements.txt 檔案且沒有使用預設全域環境的專案時，Visual Studio 會比較那些需求與目前環境中已安裝的套件。 如果遺失任何套件，Visual Studio 會顯示安裝那些相依項目的提示。
顯示通知列以設定測試架構	另一	設定時，如果 Visual Studio 偵測到 Python 專案中可能包含測試但未啟用測試架構的檔案，Visual Studio 會提示您啟用 pytest 或 unittest。
一律以系統管理員身分執行套件管理員	關閉	一律提高所有環境的 pip install 和類似套件管理員作業的權限。 安裝套件時，如果環境位於檔案系統的受保護區域 (例如 c:\Program Files)，則 Visual Studio 會提示需要系統管理員權限。 您可以在該提示中選擇一律只針對該環境提高安裝命令的權限。 如需詳細資訊，請參閱套件索引標籤。

Conda 環境選項

[工具]>[選項]>[Python]>[Conda] 底下提供了下列選項：

選項	預設	描述
Conda 可執行檔路徑	(空白)	指定 conda.exe 可執行檔的確切路徑，而不要依賴 Python 工資負載隨附的預設 Miniconda 安裝。 如果在這裡指定另一個路徑，其優先順序會高於預設安裝和登錄中指定的任何其他 conda.exe 可執行檔。 如果手動安裝較新版本的 Anaconda 或 Miniconda，或想要使用 32 位元發行版本，而不是預設的 64 位元發行版本，您可以變更此設定。

偵錯選項

在 [工具]>[選項]>[Python]>[偵錯] 底下提供了下列選項：

選項	預設	描述
發生錯誤時於執行前提示	另一	設定此選項時，Visual Studio 會提示您確認您想要執行包含錯誤的程式碼。 若要停用警告，請清除此選項。
處理序異常結束時等候輸入 處理序正常結束時等候輸入	開啟 (針對兩者)	從 Visual Studio 啟動的 Python 程式會執行它自己的主控台視窗中。 視窗預設會在關閉之前等待您按任一鍵，不論程式的結束方式為何。 若要移除該提示，並自動關閉視窗，請清除其中任一或兩個選項。
將 Tee 程式輸出至偵錯輸出視窗	另一	在不同的主控台視窗和 Visual Studio [輸出] 視窗中，顯示程式輸出。 清除此選項，只在不同的主控台視窗中顯示輸出。
發生 SystemExit 例外狀況時中斷，結束代碼為零	關閉	如果設定，請停止此例外狀況的偵錯工具。 清除時，會結束偵錯工具，而不中斷。
啟用 Python 標準程式庫的偵錯	關閉	可在偵錯時逐步執行標準程式庫原始程式碼，但會增加啟動偵錯工具所花費的時間。
顯示函數傳回值	另一	在偵錯工具 (F10) 中逐步執行函式呼叫時，[區域] 視窗中會顯示函數傳回值
顯示變數	另一	顯示四組要顯示的變數，以及如何格式化顯示 (群組、隱藏、內嵌)。 - 類別：預設值為 [群組] - 受保護：預設值為 [內嵌] - 函式：預設值為 [群組] - 特殊：預設值為 [群組]

分析選項

[工具]>[選項]>[Python]>[分析] 底下提供了下列選項：

選項	預設	描述
診斷模式	僅開啟檔案	指定語言伺服器針對問題所分析的程式碼檔案，包括 [工作區] 和 [僅開啟檔案]。
記錄層級	資訊	指定要由語言伺服器執行的記錄層級。 可能的記錄層級包括 [錯誤]、[警告]、[資訊]及 [追蹤] (提供的資訊層級逐次增加)。
類型檢查	關閉	指定要執行的類型檢查分析層級： - [關閉]：產生未解析的匯入/變數診斷，但不會進行類型檢查分析 - [基本]：使用非類型 ([關閉] 層級下所有開啟的規則) 以及基本類型檢查相關的規則 - [嚴格]：使用最高錯誤嚴重性的所有類型檢查規則，包括 [關閉] 和 [基本] 層級下所有開啟的規則
匯入格式	絕對	定義自動匯入模組時的預設格式，包括 [絕對] 或 [相對]。
虛設常式路徑	<Empty>	指定包含自訂類型虛設常式之目錄的路徑。 每個套件的類型虛設常式檔案應該位於自己的子目錄中。
搜尋路徑	<Empty>	指定匯入解析的搜尋路徑。 如果有多個路徑，則接受指定為字串並以逗號分隔的路徑，例如 ["path 1","path 2"]。
Typeshed 路徑	<Empty>	指定路徑，以使 Visual Studio 使用自訂 Typeshed 檔案而非其搭售版本。
自動新增常見的搜尋路徑，例如 'src'	另一	指出是否要根據預先定義的名稱自動新增搜尋路徑，例如 src。
為針對自動匯入、新增匯入、工作區符號等語言功能安裝的第三方程式庫和使用者檔案編製索引。	關閉	指定語言伺服器是否應該在啟動時為使用者檔案和安裝的第三方程式庫編製索引。 該索引會在功能 (包括自動匯入、快速修正、自動完成，等等) 中提供更完整的符號集。 - 設定時，Visual Studio 會為已安裝套件的最上層符號編制索引，例如 package/__init__.py 底下 all 中的符號，以及最多 2,000 個使用者檔案中的所有符號。 - 未設定時，Visual Studio 會顯示先前在編輯器中開啟或載入的檔案中引用或使用的符號。

互動式視窗選項

[工具]>[選項]>[Python]>[互動視窗] 底下提供了下列選項：

選項	預設	描述
指令碼	n/a	指定啟動指令碼的一般資料夾，以套用至所有環境的 [互動視窗]。 如需詳細資訊，請參閱啟動指令碼。 注意：此功能可能無法在您的 Visual Studio 版本中運作。
按向上鍵/向下鍵瀏覽歷程記錄	另一	使用方向鍵，在互動式視窗中瀏覽歷程記錄。 清除此設定，可改為使用方向鍵在互動式視窗的輸出中進行瀏覽。
完成模式	只評估沒有函式呼叫的運算式	決定互動視窗中運算式可用成員的程序，可能需要評估目前未完成的運算式，這樣可能會導致副作用或多次呼叫函式。 預設設定 [只評估沒有函式呼叫的運算式] 會排除呼叫函式的運算式，但會評估其他運算式。 例如，它會評估語句 a.b，但不會評估 a().b 語句。 [一律不評估運算式] 可防止所有副作用，並建議僅使用標準 IntelliSense 引擎。 [評估所有運算式] 會評估整個運算式來取得建議，不論副作用為何。
隱藏靜態分析建議	關閉	設定時，只會顯示評估運算式所取得的建議。 如果與 [完成模式] 值 [一律不評估運算式] 合併使用，則互動式視窗中不會出現任何有用的完成。

Python 文字編輯器選項

在 [文字編輯器]>[Python] 底下，有捲軸、索引標籤和格式設定選項，以及一般和進階設定：

一般 Python 編輯器選項

[工具]>[選項]>[文字編輯器]>[Python]>[一般] 底下提供了下列選項：

選項	預設	描述
自動列出成員	另一	設定此選項可自動列出程式碼陳述式完成的成員。
隱藏進階成員	另一	啟用 [自動列出成員] 選項後，設定此選項可隱藏完成建議中的進階成員。 進階成員是較不常使用的成員。
參數資訊	另一	設定時，將滑鼠停留在參數上方會顯示詳細資訊，例如項目定義和文件連結。
啟用虛擬空間	另一	設定時，會在每行程式碼的結尾插入空格。 選取這個選項，可在程式碼旁邊一致的位置上放置註解。 在 [資料行選取] 模式中會啟用 [虛擬空間] 模式。 未啟用 [虛擬空間] 模式時，插入點會從一行結尾直接移到下一行的第一個字元。 注意：此選項會受到 [文字編輯器]>[所有語言]>[一般]>[啟用虛擬空間] 全域設定的影響。 如果未啟用全域設定，則無法在語言層級啟用此選項。
自動換行	關閉	設定此選項可讓長程式碼行根據編輯器檢視區寬度換行。
顯示自動換行的視覺化圖像	關閉	啟用 [自動換行] 選項時，設定此選項可顯示視覺化圖像。
行號	關閉	設定此選項可在編輯器左邊界中顯示每個程式碼行的行號。
啟用按一下方式的 URL 巡覽	另一	設定時，您可以按一下 URL 以瀏覽至目標位置。
導覽列	關閉	設定此選項可啟用程式碼視窗頂端的下拉式方塊。 這些欄位可協助您瀏覽至程式碼基底中的程式碼，您可以在其中選擇要直接前往的類型或成員。 注意：此選項會受到 [文字編輯器]>[所有語言]>[一般]>[啟用導覽列] 全域設定的影響。 如需詳細資訊，請參閱瀏覽程式碼>導覽列。
自動以大括號完成	另一	設定時，Visual Studio 會在您輸入程式碼時，自動新增任何左大括弧的右大括弧。
沒有選取項目時，可將 [剪下] 或 [複製] 套用至空白行	另一	根據預設，當沒有明確選取時，Visual Studio 會剪下或複製整個程式碼行。 使用此選項可啟用或停用當在空白行上叫用時的此剪下或複製行為。

如需詳細資訊，請參閱 [選項] 對話方塊：[文字編輯器] > [一般]。

進階 Python 編輯器選項

[工具]>[選項]>[文字編輯器]>[Python]>[進階] 底下提供了下列選項：

選項	預設	描述
提供自動匯入完成	另一	設定時，Visual Studio 會提供完成時自動匯入。
自動新增函式括弧	關閉	設定時，Visual Studio 會在您在編輯器中輸入程式碼時自動新增函式括弧。

字型與色彩選項

當 [文字編輯器] 群組設定為 [Python] 時，[環境]>[字型和色彩] 底下提供了其他 Python 選項：

Python 選項名稱的前面都會加上 "Python"，且能輕鬆透過名稱了解其功能。 所有 Visual Studio 色彩佈景主題的預設字型都是 10 pt Consolas regular (非粗體)。 預設色彩會因佈景主題而異。 一般而言，您可以變更字型或色彩，以方便閱讀文字。