Windows10下VS Code运行Python代码报错无法执行求助

已确认故障场景 #

• 设备环境：搭载Windows 10系统的惠普笔记本，为首次在该设备上编写Python代码，使用者为Python入门阶段的IT专业大一学生，此前无同类故障经历
• 触发报错的操作1：点击VS Code右上角三角形状的运行按钮执行代码，弹出语法错误提示，反复核查代码内容未发现语法问题
• 触发报错的操作2：在VS Code终端输入python 对应文件名.py指令回车执行，触发第二类报错
• 报错截图中打码遮挡内容为个人姓名、学号，与代码逻辑无关

对应排查&解决步骤 #

按出现概率从高到低依次排查即可：

1. 修复Python解释器选择/环境变量配置问题 #

这是Windows设备首次配置Python开发环境最高发的故障点：

• 先做基础校验：按下Win+R输入cmd打开系统命令提示符（不是VS Code内置终端），输入python --version回车
  • 如果弹出微软应用商店跳转窗口，或提示「'python' 不是内部或外部命令，也不是可运行的程序或批处理文件」，说明安装Python时未勾选Add Python to PATH选项，环境变量配置缺失
  • 解决方法：找到本机Python安装目录（默认路径为C:\Users\你的系统用户名\AppData\Local\Programs\Python\Python3x\，x为你安装的Python次版本号，比如3.10版本对应Python310文件夹），把该根目录、以及根目录下的Scripts子文件夹路径，添加到系统环境变量的Path条目下，保存后重启电脑
• 环境变量配置完成后重启VS Code，按下Ctrl+Shift+P调出命令面板，输入Python: Select Interpreter回车，在弹出的解释器列表里选择你自己安装的Python版本，不要选择带Windows Store、应用执行别名相关标识的选项，再尝试运行代码

2. 修复路径兼容问题 #

Windows终端对非英文路径的兼容缺陷，经常会触发无对应代码问题的假语法报错：

• 检查你的Python文件本身、以及所有上级文件夹的命名，不要包含中文、全角符号、emoji、连续特殊空格，不要把代码放在「大一作业\Python练习」这类带中文的路径下，也不要把文件命名为第一次作业.py这类带中文的名称
• 把代码文件移动到全英文、无特殊字符的短路径下，比如D:\code\python\hw1.py，再重新执行

3. 修复Code Runner插件配置问题 #

如果点三角运行按钮的操作依赖Code Runner插件，默认配置在Windows环境下容易出现兼容问题：

• 按下Ctrl+,打开VS Code设置，搜索Code Runner: Run In Terminal，勾选对应选项，让代码在集成终端而非输出面板运行，规避编码类报错
• 如果还是报错，继续搜索Code Runner: Executor Map，找到配置项里python对应的执行命令，修改为$pythonPath -u $fullFileName后保存设置

4. 修复文件编码不匹配问题 #

如果文件保存编码和VS Code默认识别编码不一致，也会触发莫名其妙的语法报错：

• 查看VS Code状态栏右下角的编码标识（默认显示UTF-8），点击后选择「通过编码重新打开」，依次尝试UTF-8、GBK编码，确认打开后代码内容无乱码，再选择「通过编码保存」，将文件统一存为UTF-8编码后重新运行

内容的提问来源于stack exchange，提问作者Garmi