Python 設定參考
Visual Studio Code 的 Python 擴充功能具有高度可設定性。本頁面說明您可以使用的關鍵設定。
關於在 VS Code 中使用設定的通用資訊,請參閱 使用者與工作區設定,以及關於預先定義變數支援的 變數參考。
通用 Python 設定
| 設定 (python.) | 預設值 | 說明 |
|---|---|---|
| condaPath | "conda" |
conda 執行檔的路徑。 |
| defaultInterpreterPath | "python" |
Python 擴充功能首次為工作區載入時所使用的預設 Python 直譯器路徑,或是包含 Python 直譯器的資料夾路徑。可以使用如 ${workspaceFolder} 和 ${workspaceFolder}/.venv 等變數。使用資料夾路徑可讓任何使用該專案的人員根據其作業系統,在 .venv 資料夾中建立適當的環境,而無需指定與平台相關的確切路徑。接著可以將 settings.json 檔案包含在原始程式碼儲存庫中。注意:在為工作區選定直譯器後,對此設定所做的變更將不會被套用或納入 Python 擴充功能的考量。Python 擴充功能不會自動新增或變更此設定。 |
| 環境檔案 | "${workspaceFolder}/.env" |
包含環境變數定義的檔案之絕對路徑。請參閱 .env 檔案支援。 |
| experiments.enabled | true |
啟用 Python 擴充功能中的 A/B 實驗。若啟用,您可能會收到建議的增強功能及/或特性。 |
| globalModuleInstallation | false |
指定是否僅使用 --user 命令列引數(預設值)為目前使用者安裝套件,或是在設定為 true 時為全域環境中的所有使用者安裝套件。使用虛擬環境時將忽略此項。如需關於 --user 引數的詳細資訊,請參閱 pip - 使用者安裝 (User Installs)。 |
| interpreter.infoVisibility | "onPythonRelated" |
控制何時在狀態列上顯示選定的直譯器資訊。預設情況下,僅在編輯器中開啟 Python 相關檔案時才會顯示。如果您希望它始終顯示在狀態列上,可以將其設定為 "always";若要完全隱藏,則設定為 "never"。 |
| pipenvPath | "pipenv" |
用於啟動的 pipenv 執行檔路徑。 |
| poetryPath | "poetry" |
若已安裝,指定 Poetry 相依性管理員 執行檔的位置。預設值 "poetry" 假設執行檔位於目前的 PATH 路徑中。當 Poetry 可用且工作區資料夾中存在 poetry.lock 檔案時,Python 擴充功能會使用此設定來安裝套件。 |
| REPL.enableREPLSmartSend | true |
指定 Shift+Enter 是否利用「智慧傳送 (Smart Send)」。智慧傳送會查看游標所在的程式碼,將最小的可執行程式碼片段傳送到 Python REPL,然後將您的游標置於下一行程式碼。 |
| terminal.activateEnvInCurrentTerminal | false |
指定在 Python 擴充功能啟動時,是否使用所選的虛擬環境來啟動目前開啟的終端機。 |
| terminal.activateEnvironment | true |
指示建立新終端機時,是否自動啟動您使用 **Python: Select Interpreter** 命令所選取的環境。例如,當此設定為 true 且您選取了虛擬環境時,擴充功能會在建立新終端機時自動執行該環境的 activate 命令(macOS/Linux 為 source env/bin/activate;Windows 為 env\scripts\activate)。注意:當設定了 python-envs.terminal.autoActivationType 時,該設定會取代此項設定。 |
| terminal.executeInFileDir | false |
指示是否在檔案所在的目錄中執行檔案,而非在目前的資料夾中執行。 |
| terminal.focusAfterLaunch | false |
啟動 Python 終端機時是否將游標焦點切換至終端機。 |
| terminal.launchArgs | [] |
當您使用諸如 **Python: Run Python File in Terminal** 等命令執行檔案時,傳遞給 Python 直譯器的啟動引數。在 launchArgs 清單中,每個項目都是以空格分隔的頂層命令列元素(包含空格的引號值視為單一頂層元素,因此在清單中為一個項目)。例如,對於引數 --a --b --c {"value1" : 1, "value2" : 2},清單項目應為 ["--a", "--b", "--c", "{\"value1\" : 1, \"value2\" : 2}\""]。請注意,VS Code 在偵錯時會忽略此設定,因為它會改用 launch.json 中您選取的偵錯設定內的引數。 |
| terminal.useEnvFile | false |
控制是否將來自 env 檔案與 python.envFile 設定的環境變數注入終端機。 |
| venvFolders | [] |
建立虛擬環境的資料夾路徑。根據所使用的虛擬化工具,這可以是專案本身:${workspaceFolder},或是並列放置所有虛擬環境的獨立資料夾:.\envs、~/.virtualenvs 等。注意:此設定會自動與 python-envs.globalSearchPaths 合併。請考慮遷移至新設定以獲得更多功能。 |
Python 環境擴充功能設定
Python 環境擴充功能在 VS Code UI 中提供環境與套件管理。這些設定控制環境探索、建立與終端機啟動。
關於環境管理的詳細資訊,請參閱 Python 環境。
環境管理設定
| 設定 (python-envs.) | 預設值 | 說明 |
|---|---|---|
| defaultEnvManager | "ms-python.python:venv" |
用於建立與管理環境的預設環境管理員。 |
| defaultPackageManager | "ms-python.python:pip" |
用於在環境中安裝套件的預設套件管理員。 |
| pythonProjects | [] |
Python 專案清單。每個項目都是一個包含以下屬性的物件:path (字串)、envManager (字串)、packageManager (字串)。使用此設定可為多根工作區中的每個資料夾配置環境。 |
| workspaceSearchPaths | ["./**/.venv"] |
用於搜尋此工作區中環境的 Glob 模式。預設會搜尋工作區中任何名為 .venv 的資料夾。注意:此設定必須在工作區或資料夾層級進行設定,不可在使用者層級設定。 |
| globalSearchPaths | [] |
用於跨所有工作區搜尋 Python 環境的絕對路徑。適用於共用的環境資料夾,如 ~/envs。注意:舊版設定 python.venvPath 與 python.venvFolders 會自動與此設定合併。 |
| alwaysUseUv | true |
若設為 true,則在可用時將使用 uv 來管理所有虛擬環境。若設為 false,uv 僅會管理由 uv 明確建立的虛擬環境。 |
終端機設定
| 設定 (python-envs.terminal.) | 預設值 | 說明 |
|---|---|---|
| autoActivationType | "command" |
指定擴充功能如何在終端機中啟動環境。可用值:command(透過在終端機中執行命令來啟動)、shellStartup(透過 shell 整合或修改終端機 shell 啟動指令碼來啟動,支援 zsh、fish、pwsh、bash、cmd)、off(無自動啟動)。注意:此設定優先於 python.terminal.activateEnvironment。 |
| showActivateButton | false |
(實驗性) 是否在終端機選單中顯示 'Activate' 按鈕。 |
舊版設定遷移
如果您正從舊版 Python 擴充功能設定遷移,下表顯示了與新設定的對應關係
| 舊版設定 | 新設定 | 備註 |
|---|---|---|
python.venvPath |
python-envs.globalSearchPaths 或 python-envs.workspaceSearchPaths |
舊版設定仍可運作並會自動合併。請考慮遷移至使用 glob 模式。 |
python.venvFolders |
python-envs.globalSearchPaths 或 python-envs.workspaceSearchPaths |
舊版設定仍可運作並會自動合併。 |
python.terminal.activateEnvironment |
python-envs.terminal.autoActivationType |
設定為 "off" 以停用自動啟動。設定後,新設定將優先。 |
偵錯工具設定
一般偵錯
| 設定 (python.debugpy.) | 預設值 | 說明 | 參見 |
|---|---|---|---|
| debugJustMyCode | true |
指定偵錯工具是否僅應逐步執行使用者撰寫的程式碼。停用此項可讓您同時逐步執行程式庫程式碼。 | 偵錯 |
測試設定
一般測試
| 設定 (python.testing.) | 預設值 | 說明 | 參見 |
|---|---|---|---|
| autoTestDiscoverOnSaveEnabled | true |
指定是否啟用或停用儲存測試檔案時自動執行測試探索。 | 測試 |
| cwd | null | 指定測試的可選工作目錄。 | 測試 |
| debugPort | 3000 |
用於 unittest 測試偵錯的連接埠號。 | 測試 |
| promptToConfigure | true |
指定若發現潛在測試時,VS Code 是否提示設定測試架構。 | 測試 |
unittest 架構
| 設定 (python.testing.) | 預設值 | 說明 | 參見 |
|---|---|---|---|
| unittestArgs | ["-v", "-s", ".", "-p", "*test*.py"] |
傳遞給 unittest 的引數,其中每個以空格分隔的頂層元素都是清單中的一個獨立項目。 | 測試 |
| unittestEnabled | false |
指定是否啟用 unittest 進行測試。 | 測試 |
pytest 架構
| 設定 (python.testing.) | 預設值 | 說明 | 參見 |
|---|---|---|---|
| pytestArgs | [] |
傳遞給 pytest 的引數,其中每個以空格分隔的頂層元素都是清單中的一個獨立項目。在使用 pytest-cov 進行測試偵錯時,請在這些引數中包含 --no-cov。 |
測試 |
| pytestEnabled | false |
指定是否啟用 pytest 進行測試。 | 測試 |
| pytestPath | "pytest" |
pytest 的路徑。若 pytest 位於目前環境之外,請使用完整路徑。 | 測試 |
程式碼分析設定
IntelliSense 引擎設定
注意:如果您從未變更語言伺服器設定,您的語言伺服器將透過「預設」設定值設定為 Pylance。
| 設定 (python.) | 預設值 | 說明 |
|---|---|---|
| languageServer | 預設值 | 定義語言伺服器的類型(預設 (Default)、Pylance、Jedi 與 None)。 |
Python 語言伺服器設定
Pylance 語言伺服器
當 python.languageServer 為 Pylance 或 Default 時,語言伺服器設定即適用。若在使用語言伺服器時遇到困難,請參閱語言伺服器儲存庫中的 疑難排解。
| 設定 (python.analysis.) | 預設值 | 說明 |
|---|---|---|
| aiCodeActions | true | 是否啟用特定的 AI 輔助程式碼動作。需要啟用 GitHub Copilot Chat 擴充功能。接受的值為一個物件,以程式碼動作為鍵 (key),布林值為值 (value)。可用的程式碼動作:implementAbstractClasses(啟用程式碼動作以實作繼承自抽象類別的方法,並使用來自 GitHub Copilot 的 AI 建議來填入方法主體)。用法範例:{"implementAbstractClasses": true} |
| autoFormatStrings | false | 在字串內輸入 "{" 時,是否自動在其前面加上 "f"。 |
| autoImportCompletions | false | 控制自動完成中自動匯入的提供。可用值為 true 與 false。 |
| autoIndent | true | 輸入 Python 程式碼時,是否根據語言語意自動調整縮排。接受的值為 true 或 false。 |
| autoSearchPaths | true | 指示是否根據某些預先定義的名稱(如 src)自動新增搜尋路徑。可用值為 true 與 false。 |
| completeFunctionParens | false | 在函式自動完成時新增括號。接受的值為 true 與 false。 |
| diagnosticMode | openFilesOnly | 指定語言伺服器分析哪些程式碼檔案是否存在問題。可用值為 workspace 與 openFilesOnly。 |
| diagnosticSeverityOverrides | {} | 允許使用者覆寫個別診斷的嚴重性層級。對於每個規則,可用的嚴重性層級為 error(紅色波浪線)、warning(黃色波浪線)、information(藍色波浪線)與 none(規則已停用)。關於用於診斷嚴重性規則的鍵值資訊,請參閱下方的 **診斷嚴重性規則** 章節。 |
| enableEditableInstalls | false |
透過解析以可編輯模式(pip install -e .)安裝的套件之匯入路徑,啟用改良的 IntelliSense 支援,如 PEP 660 所定義。 |
| exclude | [] | 不應包含在分析中的目錄或檔案路徑。這些會覆寫 python.analysis.include 設定下所列的目錄,從而允許排除特定的子目錄。請注意,即使檔案列在此 exclude 設定中,如果它們被不在排除清單中的原始檔案引用/匯入,它們可能仍會包含在分析中。路徑可以包含萬用字元,例如 **(目錄或多層目錄)、*(零個或多個字元的序列)或 ?(單一字元)。如果未指定排除路徑,Pylance 會自動排除以下項目:**/node_modules、**/__pycache__、.git 以及任何虛擬環境目錄。 |
| extraPaths | [] | 指定用於匯入解析的額外搜尋路徑。接受以字串指定並以逗號分隔的路徑(若有多個路徑)。例如:["path 1","path 2"]。 |
| importFormat | absolute | 定義自動匯入模組時的預設格式。接受的值為 absolute 或 relative。 |
| include | [] | 應包含在分析中的目錄或檔案路徑。若未指定路徑,Pylance 預設為包含工作區根目錄的目錄。路徑可以包含萬用字元,例如 **(目錄或多層目錄)、*(零個或多個字元的序列)或 ?(單一字元)。 |
| fixAll | [] |
執行 **Fix All** 命令或 source.fixAll 程式碼動作時要執行的程式碼動作清單。接受值:source.unusedImports(移除開啟檔案中所有未使用的匯入)、source.convertImportFormat(根據 python.analysis.importFormat 設定轉換匯入)。 |
| includeAliasesFromUserFiles | false | 是否在自動匯入建議與新增匯入快速修正 (Quick Fix) 中包含來自使用者檔案的別名符號。停用時,Pylance 將提供定義該符號處的匯入建議。啟用時,它還會提供來自匯入(即別名)該符號之檔案的匯入建議。可用值為 true 與 false。 |
| ignore | [] | 應抑制其診斷輸出(錯誤與警告)的目錄或檔案路徑,即使它們是包含的檔案或在包含檔案的傳遞封閉內亦同。路徑可以包含萬用字元,例如 **(目錄或多層目錄)、*(零個或多個字元的序列)或 ?(單一字元)。如果未提供值,將使用 python.linting.ignorePatterns 的值(若已設定)。 |
| indexing | true | 用於指定 Pylance 是否應在啟動時索引使用者檔案以及安裝的第三方套件庫,以在自動匯入、快速修正、自動完成等功能中提供更完整的符號集。接受的值為 true 或 false。設為 true 時,Pylance 預設會索引已安裝套件的頂層符號(即 package/__init__.py 下 __all__ 中的符號),以及最多 2000 個使用者檔案中的所有符號。設為 false 時,Pylance 將僅顯示已在編輯器中開啟或載入過的檔案中已被引用或使用的符號。 |
| inlayHints.callArgumentNames | 關閉 | 控制呼叫引數名稱的嵌入式提示 (inlay hints) 顯示。可用值為 off、partial 與 all。設為 off 時,不顯示嵌入式提示。設為 partial 時,僅對位置引數與關鍵字引數停用提示。設為 all 時,會顯示所有參數的提示。 |
| inlayHints.functionReturnTypes | false | 是否顯示函式傳回類型的嵌入式提示。接受的值為 true 或 false。 |
| inlayHints.pytestParameters | false | 是否顯示 pytest fixture 引數類型的嵌入式提示。接受的值為 true 或 false。 |
| inlayHints.variableTypes | false | 是否顯示變數類型的嵌入式提示。接受的值為 true 或 false。 |
| languageServerMode | default | 提供預先定義的設定,以根據開發需求優化 Pylance 的效能。可用值為 default 與 light。設為 default 時,語言伺服器可為大多數機器提供足夠的功能,而不會使系統過載。設為 light 時,可啟用輕量且高效能的設定。此模式會停用各種功能,使 Pylance 的運作更像一個簡化的文字編輯器,非常適合不需要 IntelliSense 全部功能並偏好 Pylance 盡可能節省資源的使用者。在 light 模式下,會覆寫以下設定:python.analysis.exclude 設為 ["**"],python.analysis.useLibraryCodeForTypes 設為 false,python.analysis.enablePytestSupport 設為 false,且 python.analysis.indexing 設為 false。 |
| logLevel | Error |
指定語言伺服器執行的記錄層級。可能的記錄層級依資訊豐富程度遞增為:Error、Warning、Information 與 Trace。 |
| nodeArguments | "--max-old-space-size=8192" |
指定直接給 python.analysis.nodeExecutable 所定義之自訂 Node.js 執行檔的自訂引數。這可用於分配更多記憶體或設定 Node.js 行為。接受 Node.js 支援的引數清單。每個 "arg=value" 都應以逗號分隔。用法範例:"python.analysis.nodeArguments": ["--max-old-space-size=8192"] |
| nodeExecutable | "" |
指定要使用的 Node.js 執行檔,這允許 Pylance 分配更多記憶體。接受的值為包含執行檔路徑的字串、空字串或 "auto"。設為空字串時,Pylance 將使用 VS Code 的 node 執行檔。設為 "auto" 時,它會自動下載 Node.js。 |
| packageIndexDepths | [] | 用於根據每個套件覆寫已安裝套件下要索引的層級深度。預設僅索引頂層模組(深度 = 1)。若要索引子模組,請為您想索引的每個子模組層級將深度加 1。接受的物件元組,例如 {"name": "套件名稱 (str)", "depth": "掃描深度 (int)", "includeAllSymbols": "是否包含所有符號 (bool)"}。若 includeAllSymbols 設為 false,則僅包含每個套件 __all__ 中的符號。設為 true 時,Pylance 將索引檔案中的每個模組/頂層符號宣告。用法範例:[{"name": "sklearn", "depth": 2, "includeAllSymbols": true}, {"name": "matplotlib", "depth": 3, "includeAllSymbols": false}] |
| stubPath | ./typings | 指定包含自訂類型存根 (type stubs) 的目錄路徑。每個套件的類型存根檔案預期位於其自己的子目錄中。 |
| typeCheckingMode | 關閉 | 指定要執行的類型檢查分析層級。可用值為 off、basic 與 strict。設為 off 時,不執行任何類型檢查分析;僅產生無法解析的匯入/變數診斷。設為 basic 時,使用非類型檢查相關規則(即 off 中的所有規則)以及基礎類型檢查規則。設為 strict 時,使用所有處於錯誤最高嚴重性的類型檢查規則(包括 off 與 basic 類別中的所有規則)。 |
| useLibraryCodeForTypes | true | 當找不到類型存根時,解析套件的原始程式碼。可用值為 true 與 false。 |
| userFileIndexingLimit | 2000 | 設定 Pylance 在工作區中索引的使用者檔案上限。設為 -1 時,Pylance 將索引所有檔案。請注意,索引檔案是一項高效能消耗的任務。 |
診斷嚴重性規則
本章節詳細說明所有可使用 python.analysis.diagnosticSeverityOverrides 設定自訂的可用規則,如下列範例所示。
{
"python.analysis.diagnosticSeverityOverrides": {
"reportUnboundVariable": "information",
"reportImplicitStringConcatenation": "warning"
}
}
| 值 | 說明 |
|---|---|
| reportAssertAlwaysTrue | 針對可能永遠為真的 'assert' 陳述式進行診斷。這可能表示程式設計錯誤。 |
| reportCallInDefaultInitializer | 針對預設值初始化表達式內的函式呼叫進行診斷。此類呼叫可能會掩蓋在模組初始化時執行的昂貴操作。 |
| reportConstantRedefinition | 針對嘗試重新定義變數名稱(全大寫並帶有底線與數字)進行診斷。 |
| reportDuplicateImport | 針對重複匯入的符號或模組進行診斷。 |
| reportFunctionMemberAccess | 針對對函式進行成員存取進行診斷。 |
| reportGeneralTypeIssues | 針對一般類型不一致、不支援的操作、引數/參數不匹配等進行診斷。這涵蓋了其他規則未涵蓋的所有基礎類型檢查規則。它不包含語法錯誤。 |
| reportImportCycles | 針對循環匯入鏈進行診斷。這些在 Python 中並非錯誤,但它們確實會拖慢類型分析,通常暗示了架構層級問題。通常應避免此類情況。 |
| reportImplicitStringConcatenation | 針對兩個或多個連續字串常數進行診斷,表示隱式串接。這被視為不良做法,且常掩蓋了諸如遺漏逗號等錯誤。 |
| reportIncompatibleMethodOverride | 針對以不相容方式(錯誤的參數數量、不相容的參數類型或不相容的傳回類型)覆寫基底類別中同名方法的方法進行診斷。 |
| reportIncompatibleVariableOverride | 針對覆寫基底類別中同名符號但類型與基底類別符號類型不相容的類別變數宣告進行診斷。 |
| reportInvalidStringEscapeSequence | 針對在字串常數內使用的無效跳脫序列進行診斷。Python 規格指出,此類序列在未來版本中將產生語法錯誤。 |
| reportInvalidStubStatement | 針對不應出現在存根檔案中的陳述式進行診斷。 |
| reportInvalidTypeVarUse | 針對函式簽章中不當使用類型變數進行診斷。 |
| reportMissingImports | 針對沒有對應匯入的 python 檔案或類型存根檔案的匯入進行診斷。 |
| reportMissingModuleSource | 針對沒有對應來源檔案的匯入進行診斷。當找到類型存根但找不到模組來源檔案時會發生此情況,這表示在使用此執行環境時,程式碼可能會在執行階段失敗。類型檢查將使用類型存根完成。 |
| reportMissingTypeArgument | 針對在未提供明確或隱式類型引數的情況下使用泛型類別進行診斷。 |
| reportMissingTypeStubs | 針對沒有對應類型存根檔案(typeshed 檔案或自訂類型存根)的匯入進行診斷。類型檢查器需要類型存根才能達到最佳的分析效果。 |
| reportOptionalCall | 針對嘗試呼叫 Optional 類型變數進行診斷。 |
| reportOptionalContextManager | 針對嘗試將 Optional 類型用作內容管理員(作為 with 陳述式的參數)進行診斷。 |
| reportOptionalIterable | 針對嘗試將 Optional 類型用作可迭代值(例如在 for 陳述式中)進行診斷。 |
| reportOptionalMemberAccess | 針對嘗試存取 Optional 類型變數的成員進行診斷。 |
| reportOptionalOperand | 針對嘗試將 Optional 類型用作二元或一元運算子(如 '+'、'=='、'or'、'not')的運算元進行診斷。 |
| reportOptionalSubscript | 針對嘗試對 Optional 類型變數進行下標(索引)進行診斷。 |
| reportPrivateUsage | 針對不正確使用私有或受保護變數或函式進行診斷。受保護類別成員以單底線 _ 開頭,僅能由子類別存取。私有類別成員以雙底線開頭但不以雙底線結尾,僅能在宣告類別內存取。在類別外宣告的變數與函式,若其名稱以單或雙底線開頭,則被視為私有,且無法在宣告模組外存取。 |
| reportPropertyTypeMismatch | 針對傳遞給 setter 的值類型無法指派給 getter 傳回的值類型的屬性進行診斷。此類不匹配違反了屬性的本意,屬性旨在像變數一樣運作。 |
| reportSelfClsParameterName | 針對執行個體方法中遺漏或命名錯誤的 “self” 參數,以及類別方法中 “cls” 參數進行診斷。元類別(繼承自 “type” 的類別)中的執行個體方法允許將 “cls” 用於執行個體方法。 |
| reportUndefinedVariable | 針對未定義的變數進行診斷。 |
| reportUnboundVariable | 針對未繫結或可能未繫結的變數進行診斷。 |
| reportUnknownArgumentType | 針對具有未知類型的函式或方法之呼叫引數進行診斷。 |
| reportUnknownLambdaType | 針對具有未知類型的 Lambda 輸入或傳回參數進行診斷。 |
| reportUnknownMemberType | 針對具有未知類型的類別或執行個體變數進行診斷。 |
| reportUnknownParameterType | 針對具有未知類型的函式或方法之輸入或傳回參數進行診斷。 |
| reportUnknownVariableType | 針對具有未知類型的變數進行診斷。 |
| reportUnnecessaryCast | 針對靜態確定為不必要的 'cast' 呼叫進行診斷。此類呼叫有時表示程式設計錯誤。 |
| reportUnnecessaryIsInstance | 針對 'isinstance' 或 'issubclass' 呼叫進行診斷,其中結果靜態確定為總是真或總是假。此類呼叫通常表示程式設計錯誤。 |
| reportUnusedCallResult | 針對呼叫表達式進行診斷,其結果未被消耗且非 None。 |
| reportUnusedClass | 針對具有私有名稱(以底線開頭)且未被存取的類別進行診斷。 |
| reportUnusedCoroutine | 針對傳回 Coroutine 且結果未被消耗的呼叫表達式進行診斷。 |
| reportUnusedFunction | 針對具有私有名稱(以底線開頭)且未被存取的函式或方法進行診斷。 |
| reportUnusedImport | 針對未在檔案內引用的匯入符號進行診斷。 |
| reportUnusedVariable | 針對未被存取的變數進行診斷。 |
| reportUnsupportedDunderAll | 針對在 __all__ 上執行的不支援操作進行診斷。 |
| reportWildcardImportFromLibrary | 針對來自外部套件庫的萬用字元匯入進行診斷。 |
自動完成設定
| 設定 (python.autoComplete.) | 預設值 | 說明 | 參見 |
|---|---|---|---|
| extraPaths | [] |
指定要載入自動完成資料的額外套件位置。 | 編輯 |
預先定義變數
Python 擴充功能設定支援預先定義變數。與通用 VS Code 設定類似,變數使用 ${variableName} 語法。具體而言,擴充功能支援下列變數
-
${cwd} - 啟動時任務執行程式的目前工作目錄
-
${workspaceFolder} - 在 VS Code 中開啟的資料夾路徑
-
${workspaceRootFolderName} - 在 VS Code 中開啟的資料夾名稱,不含任何斜線 (/)
-
${workspaceFolderBasename} - 在 VS Code 中開啟的資料夾名稱,不含任何斜線 (/)
-
${file} - 目前開啟的檔案
-
${relativeFile} - 目前開啟的檔案相對於
workspaceFolder的路徑 -
${relativeFileDirname} - 目前開啟檔案的目錄名稱相對於
workspaceFolder的路徑 -
${fileBasename} - 目前開啟檔案的基本名稱
-
${fileBasenameNoExtension} - 目前開啟檔案的基本名稱,不含副檔名
-
${fileDirname} - 目前開啟檔案的目錄名稱
-
${fileExtname} - 目前開啟檔案的副檔名
-
${lineNumber} - 作用中檔案中目前選取的行號
-
${selectedText} - 作用中檔案中目前選取的文字
-
${execPath} - 執行中的 VS Code 執行檔路徑
關於預先定義變數的更多資訊與用法範例,請參閱一般 VS Code 文件中的 變數參考。