安装Udemy课程指定工具后VSCode无法运行Python,求解决步骤
VSCode Python运行异常完整排查修复流程
第一步:确认Python解释器选择正确
- 打开任意Python文件,按
Ctrl+Shift+P(Mac设备为Cmd+Shift+P)调出命令面板,输入Python: Select Interpreter执行该命令 - 弹出的解释器列表中,优先选择你原本正常使用的全局Python路径(Windows通常为
C:\Users\你的用户名\AppData\Local\Programs\Python\Python版本号\python.exe,Mac/Linux通常为/usr/bin/python3或/usr/local/bin/python3),不要选择带venv、virtualenv、conda-env前缀的虚拟环境路径,除非你明确当前项目需要使用指定虚拟环境 - 选择完成后直接运行代码测试是否恢复正常
第二步:校验并修复终端环境变量
- 按
Ctrl+`调出VSCode内置终端,输入对应命令查看Python版本:Windows输入py --version,Mac/Linux输入python3 --version,输出的版本需和上一步选择的解释器版本一致 - 如果版本不一致,先手动输入上一步选中的完整解释器路径运行代码测试,例如Windows运行
C:\Users\xxx\AppData\Local\Programs\Python\Python311\python.exe 你的代码文件名.py,如果运行正常说明是环境变量被安装的工具修改导致的问题 - 修复环境变量:Windows打开系统环境变量编辑页,在
Path项中将Python安装路径、对应Scripts路径(例如C:\Users\xxx\AppData\Local\Programs\Python\Python311\Scripts)上移到最顶部,覆盖安装工具时新增的优先级更高的错误Python路径;Mac/Linux编辑~/.zshrc或~/.bashrc文件,在末尾新增export PATH="你的Python正确安装路径:$PATH",保存后重启终端生效
第三步:重置Python扩展配置
- 前两步操作无效的情况下,调出命令面板输入
Extensions: Show Installed Extensions执行 - 找到Python扩展,点击齿轮图标选择
Reset Extension Settings,重置完成后重启VSCode,重新选择正确的Python解释器再运行测试
第四步:清理无效虚拟环境关联
- 如果是在当前项目文件夹下按照课程指引创建了虚拟环境,直接删除项目根目录下的
.venv(或其他自定义命名的虚拟环境文件夹),重启VSCode后重新选择全局Python解释器即可
内容的提问来源于stack exchange,提问作者DSGQR
相关产品推荐
相关产品推荐

