VSCode里Code Runner跑Python总报9009？别慌，检查一下你的setting.json文件
VSCode中Code Runner执行Python报错9009的终极排查指南
当你第一次在VSCode中用Code Runner插件运行Python脚本，满心期待看到输出结果时，终端却弹出"Process exited with code 9009"的红色错误提示——这种挫败感我深有体会。这个看似神秘的错误代码背后，其实隐藏着几个常见但容易被忽视的配置陷阱。本文将带你系统性地解剖问题根源，并提供可立即操作的解决方案。
1. 错误9009的本质与常见诱因
错误代码9009在Windows系统中通常表示"系统找不到指定的文件"。当Code Runner尝试执行Python脚本时，它实际上是在调用系统命令来运行Python解释器。如果系统无法定位到Python可执行文件的位置，就会抛出这个错误。
导致此问题的三大典型原因包括：
Python未正确安装或未添加到系统PATH
这是最常见的情况。如果Python安装时未勾选"Add Python to PATH"选项，或者PATH环境变量被意外修改，系统将无法识别python命令。Code Runner的executorMap配置错误
Code Runner通过executorMap设置来确定如何执行不同语言的代码。如果其中的Python执行命令配置不当，会导致调用失败。VSCode工作区或用户设置冲突
有时项目特定的.vscode/settings.json会覆盖全局设置，或者不同扩展的设置相互干扰。
2. 基础环境检查：Python与PATH验证
在深入VSCode配置之前，我们需要先确认基础环境是否正常。打开系统命令行（cmd或PowerShell），依次执行以下检查：
# 检查Python是否可识别 python --version # 或尝试python3（某些系统区分python2和python3） python3 --version如果这些命令返回"不是内部或外部命令"的错误，说明Python未正确添加到PATH。此时你需要：
- 找到Python安装路径（通常类似
C:\Users\你的用户名\AppData\Local\Programs\Python\Python39） - 将该路径（以及其下的Scripts子目录）添加到系统环境变量PATH中
- 重新启动所有终端和VSCode使更改生效
提示：在Windows上，Python安装程序通常提供"Add Python to PATH"选项，建议重新运行安装程序并勾选此选项。
3. Code Runner核心配置解析
Code Runner的行为主要由VSCode的settings.json文件控制。按下Ctrl+,打开设置，点击右上角的"打开设置(JSON)"图标，找到或添加以下关键配置：
{ "code-runner.executorMap": { "python": "python -u $fullFileName" }, "code-runner.runInTerminal": true, "code-runner.saveFileBeforeRun": true }关键参数说明：
| 参数 | 类型 | 默认值 | 推荐设置 | 作用 |
|---|---|---|---|---|
| executorMap.python | string | 空 | "python -u $fullFileName" | 定义Python文件的执行命令 |
| runInTerminal | boolean | false | true | 在终端而非输出窗口运行 |
| saveFileBeforeRun | boolean | false | true | 运行前自动保存文件 |
如果问题仍然存在，可以尝试显式指定Python路径：
{ "code-runner.executorMap": { "python": "\"C:\\path\\to\\python.exe\" -u $fullFileName" } }4. 高级排查：工作区与用户设置冲突
VSCode的设置具有层级结构，可能会因作用域不同而产生冲突。按照以下优先级检查设置：
- 工作区设置（项目根目录下的
.vscode/settings.json） - 用户设置（全局配置）
- 默认设置
在VSCode中，你可以通过以下方式查看各层级的实际生效值：
- 打开命令面板（
Ctrl+Shift+P） - 搜索并选择"Preferences: Open Settings (UI)"
- 在搜索栏输入"code-runner"
- 查看每个设置项右上角的"Modified In"提示
如果发现工作区设置覆盖了你的用户设置，可以：
- 删除工作区设置文件中的冲突项
- 或者明确指定你需要的配置
5. 替代方案与最佳实践
如果经过以上步骤问题仍未解决，可以考虑以下替代方案：
使用VSCode内置的Python扩展运行
安装Microsoft官方的Python扩展后，你可以：- 直接点击代码右上角的运行按钮
- 使用
F5启动调试模式
配置Python解释器路径
在settings.json中添加：{ "python.pythonPath": "C:\\path\\to\\python.exe" }创建虚拟环境
对于项目特定的Python环境，建议：# 创建虚拟环境 python -m venv .venv # 在VSCode中选择该解释器
经过这些系统性的排查和配置，大多数9009错误都能得到解决。我在帮助团队新人配置环境时，发现90%的此类问题都源于PATH设置不当或executorMap配置错误。记住，好的开发环境配置是高效编程的第一步，花时间解决这些问题将为后续工作省下大量时间。