VS Code终端默认Python版本为2.7.16,如何设置为Python3?
解决VS Code终端默认使用Python2的问题
一、核心原因说明
VS Code右下角显示的是编辑器关联的Python解释器,但终端的Python版本由系统环境变量PATH的优先级决定——Python2的路径排在了Python3前面,导致终端默认调用Python2。
二、系统层面修改默认Python(分系统)
macOS/Linux系统
- 先获取Python3的实际路径:
在终端执行命令:
会得到类似which python3/usr/local/bin/python3的路径。 - 修改shell配置文件:
- 若使用bash,编辑
~/.bash_profile或~/.bashrc;若使用zsh,编辑~/.zshrc。 - 在文件末尾添加别名配置:
注意把路径替换成你刚才查到的Python3实际路径。alias python="/usr/local/bin/python3" alias pip="/usr/local/bin/pip3"
- 若使用bash,编辑
- 让配置生效:
执行source ~/.bashrc(bash环境)或source ~/.zshrc(zsh环境),之后重启终端,输入python --version验证版本。
Windows系统
- 找到Python3的安装路径:
一般为C:\Users\你的用户名\AppData\Local\Programs\Python\Python311(对应3.11版本),复制该文件夹路径。 - 修改系统环境变量:
- 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」。
- 在「系统变量」中找到
Path并点击编辑。 - 将Python3的路径移到最上方,确保优先级高于Python2的路径;同时添加Python3路径下的
Scripts文件夹(如C:\Users\你的用户名\AppData\Local\Programs\Python\Python311\Scripts),保证pip默认使用pip3。
- 重启终端和VS Code,输入
python --version验证。
三、VS Code专属配置(不修改系统全局)
如果不想改动系统全局设置,仅让VS Code终端默认使用Python3:
- 打开VS Code设置:按
Ctrl+,(Windows)或Cmd+,(macOS)。 - 搜索对应系统的终端环境变量设置:「terminal.integrated.env.osx」(macOS)、「terminal.integrated.env.linux」(Linux)或「terminal.integrated.env.windows」(Windows)。
- 点击「编辑 in settings.json」,添加配置:
- macOS/Linux示例:
把"terminal.integrated.env.osx": { "PATH": "/usr/local/bin:$PATH" }/usr/local/bin替换为Python3所在的目录(即which python3结果去掉最后的/python3)。 - Windows示例:
"terminal.integrated.env.windows": { "PATH": "C:\\Users\\你的用户名\\AppData\\Local\\Programs\\Python\\Python311;C:\\Users\\你的用户名\\AppData\\Local\\Programs\\Python\\Python311\\Scripts;%PATH%" }
- macOS/Linux示例:
- 保存配置后重启VS Code终端,测试
python --version。
四、虚拟环境相关设置
你之前使用source env/bin/activate激活Python3虚拟环境,可通过以下优化让终端自动适配:
- 在VS Code设置中搜索「python.terminal.activateEnvironment」,勾选该选项,这样打开终端时会自动激活当前项目的虚拟环境,确保默认使用Python3。
五、验证pip默认版本
修改完成后,输入pip --version,应显示对应Python3的pip版本。若仍指向pip2,可通过上述系统别名(macOS/Linux)或环境变量(Windows)将pip指向pip3。
内容的提问来源于stack exchange,提问作者AmberG
相关产品推荐
相关产品推荐

