一、通過命令面板快速切換（推薦方法）

• 打開命令面板
  • 快捷鍵：Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）

  • 輸入命令：Python: Select Interpreter，回車后顯示所有檢測到的解釋器列表

• 選擇或手動指定路徑
  • 直接點擊列表中已檢測到的解釋器（如 venv/bin/python 或系統(tǒng)路徑）

  • 若未列出，點擊 Enter interpreter path... 手動輸入絕對路徑（如 /usr/local/bin/python3.12）

• 驗證生效
  底部狀態(tài)欄會顯示當(dāng)前選擇的 Python 版本，終端輸入 python --version 確認

二、通過 settings.json 配置（項目級/全局）

項目級配置（優(yōu)先級最高）• 打開項目根目錄下的 .vscode/settings.json 文件（沒有則新建）

 添加字段（注意路徑格式）：

{
  "python.defaultInterpreterPath": "C:\\Python312\\python.exe",  // Windows
  // 或 macOS/Linux
  "python.defaultInterpreterPath": "/usr/local/bin/python3.12"
}

全局用戶配置• 快捷鍵 Ctrl+, 打開設(shè)置，搜索 Python Path

• 點擊 Edit in settings.json，添加相同字段（適用于所有項目）

路徑格式注意：

•  Windows：雙反斜杠或正斜杠（D:/project/venv/Scripts/python.exe）
•  Unix 系統(tǒng)：直接使用絕對路徑（/home/user/venv/bin/python）

三、虛擬環(huán)境專用配置

自動檢測
在項目目錄創(chuàng)建虛擬環(huán)境后，VS Code 通常會自動識別 .venv 目錄下的解釋器，并在狀態(tài)欄提示選擇

手動指定虛擬環(huán)境路徑

在 settings.json 中配置：

{
  "python.venvPath": "${workspaceFolder}/.venv",
  "python.defaultInterpreterPath": "${workspaceFolder}/.venv/bin/python"
}

四、環(huán)境變量法（系統(tǒng)級控制）

設(shè)置 PYTHONPATH 變量

• Windows：系統(tǒng)屬性 → 高級 → 環(huán)境變量 → 新建系統(tǒng)變量 PYTHONPATH=你的路徑
• macOS/Linux：在 ~/.zshrc 或 ~/.bashrc 中添加：

export PYTHONPATH="/usr/local/custom_python_path:$PYTHONPATH"

→ 執(zhí)行 source ~/.zshrc 生效

VS Code 讀取環(huán)境變量

重啟 VS Code 或在終端執(zhí)行 echo $PYTHONPATH 確認變量已加載

五、常見問題與排查

路徑未生效

• 檢查路徑拼寫錯誤（尤其是 Windows 的轉(zhuǎn)義符）
• 執(zhí)行 which python（Unix）或 where python（Windows）驗證實際路徑
• 重載 VS Code 窗口（命令面板輸入 Developer: Reload Window）

多版本沖突

• 使用 py launcher（Windows）或 update-alternatives（Linux）管理多版本
• 在 VS Code 中為不同工作區(qū)單獨配置路徑

擴展兼容性

• 確保已安裝最新版 Python 擴展（作者：Microsoft）
• 禁用其他 Python 相關(guān)插件避免沖突

六、擴展技巧

動態(tài)路徑模板：

使用 ${env:USERPROFILE}（Windows）或 ${HOME}（Unix）簡化配置：

"python.defaultInterpreterPath": "${env:HOME}/.pyenv/versions/3.12/bin/python"

遠程開發(fā)：

在 SSH 或容器環(huán)境中，通過 Remote-SSH 擴展在遠程機的 settings.json 中配置路徑

通過以上方法，你可以精準控制 VS Code 中 Python SDK 的執(zhí)行環(huán)境。如需查看官方最新配置參數(shù)，可訪問 Python Extension Documentation。

到此這篇關(guān)于VSCode設(shè)置python SDK路徑的實現(xiàn)步驟的文章就介紹到這了,更多相關(guān)VSCode設(shè)置python SDK路徑內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論