如何在 VSCode 中使用 Code Runner 指定特定版本的解释器运行

在 VSCode 里用 Code Runner 运行 Python 代码，最让人头疼的坑是什么？不是代码本身写错了，而是你明明在右下角选好了 conda 环境或 Python 3.11，一点“Run Code”，它却偷偷调用了系统默认的 python 命令，结果包找不到、语法报错、中文乱码一股脑全来了。根本原因就一句话：Code Runner 不认 VSCode 的 Python 解释器设置，你得亲自告诉它该用哪个。

要解决这个问题，核心就是配置 code-runner.executorMap——这是 Code Runner 自己的“命令字典”，它只从这里读取执行命令。别看 UI 上有个输入框，手写 settings.json 才是最靠谱的方式，不容易漏掉引号或路径转义。

怎么改 code-runner.executorMap 配置

直接编辑 settings.json，别嫌麻烦。打开设置（Ctrl+,），搜索 code runner executor map，点“在 settings.json 中编辑”，找到或新增 "code-runner.executorMap" 对象。关键在于 python 键的值必须是一个绝对路径。

• Windows 示例："python": "C:\\Users\\name\\AppData\\Local\\Programs\\Python\\Python311\\python.exe"（双反斜杠或正斜杠都行，路径带空格记得在外层加英文双引号）
• macOS/Linux 示例："python": "/opt/homebrew/bin/python3.11"，或者直接用虚拟环境的路径："python": "/path/to/venv/bin/python"
• 关于 $pythonPath 变量：如果非要用这个变量，那就得确保 python.defaultInterpreterPath 和它指向的是同一个可执行文件，否则变量会 fallback 到系统默认的 python 命令，又白忙活了。

为什么不能只靠 Python: Select Interpreter

很多新手会困惑：我明明在 VSCode 底部状态栏看到了“Python 3.11.9 ('venv')”，怎么 Code Runner 还是用错了？原因很简单——VSCode 的 Python 插件和 Code Runner 是两个独立的系统。前者管智能提示、调试、Pylance，后者只管自己配置里那行命令字符串。两者互不干扰，但也不会互相借力。

• 你在状态栏看到的环境选择，跟 Code Runner 一毛钱关系都没有。
• 如果运行时报 ModuleNotFoundError，但你在终端里 pip list 又能看到那个包，那基本就是解释器没对上。
• 最快验证方式：在代码里加一行 print(sys.executable)，看看实际执行的是哪个路径。

常见坑：中文乱码、scanf 卡住、路径含空格

这些问题表面上八竿子打不着，但根源往往就是解释器路径配置不当或者执行方式不匹配。

• 中文输出乱码：Windows 下如果用的是 cmd 终端，配置里可以加上 "set PYTHONIOENCODING=utf-8 && " 前缀（注意最后的空格），强制让编码统一。
• input() 卡住：记得勾选 code-runner.runInTerminal，否则代码跑在只读的输出面板里，根本接收不到键盘输入。
• 路径含空格：比如 C:\Program Files\Python311，整个路径必须用英文双引号包裹，否则 JSON 解析会失败，系统也找不到命令。
• 改完不生效？ 重启 VSCode，然后右键文件 → “Run Code”，留意右下角弹出的提示信息，它会显示实际调用的完整命令行。一眼就能看出用的是不是你指定的路径。

另外还有一个容易忽略的点：workspace 级别的 settings.json 优先级高于 user 级别。如果你开了多根工作区，或者子文件夹里有自己的 .vscode/settings.json，必须确保修改的是当前文件所在文件夹下的那个配置文件，而不是上级目录的。否则改了半天，Code Runner 压根没加载到。