快捷導(dǎo)航

在VS Code中切換和設(shè)置Python解釋器的完整指南

更新時(shí)間：2026年03月20日 09:22:13 作者：算法小狂人

這篇文章主要為大家詳細(xì)介紹了在VS Code中切換Python環(huán)境的詳細(xì)方法,支持Windows/macOS/Linux系統(tǒng)及虛擬環(huán)境/Conda環(huán)境,有需要的小伙伴可以了解下

1. 準(zhǔn)備工作

已安裝 VS Code 與 Python 擴(kuò)展（Microsoft 出品）。
已安裝目標(biāo) Python 版本（系統(tǒng)版、官網(wǎng)版、Anaconda、Miniconda、pyenv 均可）。

2. 快速切換（單項(xiàng)目生效）

步驟	操作說(shuō)明	圖示/快捷鍵
① 打開(kāi)項(xiàng)目	把文件夾拖進(jìn) VS Code 或 File > Open Folder	—
② 調(diào)出命令面板	Ctrl+Shift+P（Win/Linux） Cmd+Shift+P（Mac）	直接使用快捷鍵
③ 選擇解釋器	輸入 Python: Select Interpreter 并回車
④ 點(diǎn)選目標(biāo)環(huán)境	列表里會(huì)顯示： • 系統(tǒng) Python • .venv / venv 虛擬環(huán)境 • Conda 環(huán)境 • pyenv 版本	帶 ★ 的為當(dāng)前選中項(xiàng)
⑤ 驗(yàn)證	新建終端（Ctrl+`）執(zhí)行 python -V 或 which python	路徑應(yīng)與所選一致

切換后，VS Code 底部狀態(tài)欄的 Python 版本字樣會(huì)立即更新。

此設(shè)置僅對(duì)當(dāng)前工作區(qū)生效，不會(huì)污染全局配置。

3. 手動(dòng)指定（未自動(dòng)識(shí)別時(shí)）

若列表里找不到所需解釋器：

在第 ④ 步選擇 Enter interpreter path… → Find…

瀏覽到對(duì)應(yīng)可執(zhí)行文件：

平臺(tái)	典型路徑示例
Windows	C:\Users\<User>\AppData\Local\Programs\Python\Python311\python.exe
macOS	/usr/local/bin/python3.11 或 ~/.pyenv/versions/3.11.6/bin/python
Linux	/usr/bin/python3.11 或 ~/.local/share/virtualenvs/proj/bin/python

確認(rèn)后，VS Code 會(huì)把該路徑寫(xiě)入當(dāng)前工作區(qū)的 .vscode/settings.json：

{
  "python.defaultInterpreterPath": "/absolute/path/to/python"
}

4. 設(shè)置默認(rèn)解釋器（全局新窗口生效）

想讓每次打開(kāi)新文件夾都自動(dòng)使用同一解釋器：

命令面板 → Preferences: Open User Settings (JSON)

加入：

"python.defaultInterpreterPath": "/absolute/path/to/python"

注意：如果該工作區(qū)已經(jīng)手動(dòng)選過(guò)解釋器，則全局設(shè)置會(huì)被覆蓋。

5. 常用場(chǎng)景速查

場(chǎng)景	操作建議
為每個(gè)項(xiàng)目隔離依賴	項(xiàng)目根目錄 python -m venv .venv → 激活 → 按第 2 步選 .venv/bin/python
使用 Conda 環(huán)境	conda create -n tf213 python=3.9 → 激活 → VS Code 會(huì)自動(dòng)列出，或手動(dòng)選 Enter interpreter path…
使用 pyenv 多版本	pyenv local 3.10.12 → 重啟 VS Code → 解釋器列表即出現(xiàn)對(duì)應(yīng)版本
遠(yuǎn)程/WSL 開(kāi)發(fā)	先在本機(jī) WSL 內(nèi)安裝 Python → VS Code 連接 WSL → 步驟同上

6. 一鍵驗(yàn)證代碼

新建 hello.py：

import sys, platform
print("當(dāng)前解釋器:", sys.executable)
print("版本:", platform.python_version())

點(diǎn)擊右上角 ?? Run Python File 或 Ctrl+Alt+N，終端輸出路徑與狀態(tài)欄一致即成功。

7. 常見(jiàn)問(wèn)題

問(wèn)題	解決思路
選完解釋器后仍報(bào)錯(cuò) No module named xxx	檢查終端提示符前是否有虛擬環(huán)境括號(hào)，若無(wú)，重啟 VS Code 或手動(dòng)激活環(huán)境
每次打開(kāi)都要重新選	把路徑寫(xiě)進(jìn)工作區(qū) .vscode/settings.json 或全局 settings.json
狀態(tài)欄不顯示版本	確認(rèn)已安裝 Python 擴(kuò)展；若仍不顯示，命令面板 → Developer: Reload Window

到此這篇關(guān)于在VS Code中切換和設(shè)置Python解釋器的完整指南的文章就介紹到這了,更多相關(guān)VS Code切換和設(shè)置Python解釋器內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: