如何在 VSCode 中解决运行代码时出现的路径溢出错误

你有没有遇到过这种情况：代码明明在终端里手动运行一切正常，但一按 VSCode 的“运行”按钮或F5调试，就立刻报错说找不到文件？其实，你遇到的十有八九不是什么“路径溢出错误”，而是FileNotFoundError或ENOENT，问题根源非常简单——当前工作目录（cwd）和你代码里写的相对路径没对上。

这就好比你在厨房里找锅，却跑去了卧室——不是锅丢了，是你站错了地方。

为什么一运行就找不到文件，跟内存没关系

无论是 Python 的 open("config.json")、Node.js 的 fs.readFile("./data.csv")，还是 C++ 的 fopen("input.txt","r")，这些调用在解析路径时，依赖的都是当前进程的 cwd。而问题在于，VSCode 默认并不保证这个 cwd 就是你正在编辑的那个文件所在的目录。

• 使用 Code Runner 按 Ctrl+Alt+N 时，默认以项目根目录为 cwd
• 按下 F5 调试时，如果 launch.json 里没指定 cwd，它可能会跑到用户主目录，或者继承上一次残留的路径
• 新开的终端，它的 pwd 是你上次关掉前的位置，而不是当前文件夹

每个执行入口都在用自己的规则猜测你的意图，结果自然就乱套了。

Code Runner 路径出问题？两行配置就能解决

这应该是最常见的场景。核心配置其实就两行，需要写进 VSCode 的 settings.json（打开方式：Ctrl+, → 右上角点击那个打开 settings.json 的图标）。

• "code-runner.fileDirectoryAsCwd": true —— 强制让每次运行时，cwd 都设为当前文件所在目录
• "code-runner.runInTerminal": true —— 避免复用旧终端的路径缓存，确保新开一个干净的终端

顺带提一句，如果你用了虚拟环境，最好再检查一下 code-runner.executorMap 里的 python 值，看它是否指向正确的解释器。比如 macOS/Linux 下可能是 ./venv/bin/python，Windows 下则是 venv\Scripts\python.exe。

改完后不需要重启VSCode，下次按快捷键立刻生效。需要明确的是，这个设置只影响 Code Runner，不管调试和终端。

调试（F5）时 cwd 还是错的？问题出在 launch.json

调试和 Code Runner 是两套独立的机制，必须在 .vscode/launch.json 里，为每个 configurations 项显式声明 cwd。

• 推荐使用 "cwd": "${fileDirname}" —— 动态取当前文件所在的目录，这是最安全的做法
• 千万别写 "cwd": "./src" 这样的硬编码路径，因为它的基准是 ${workspaceFolder}，一旦文件不在 src 下，立马失效
• 另外要确认，你是通过「文件 → 打开文件夹」加载的整个项目，否则 ${workspaceFolder} 和 ${fileDirname} 都可能为空或路径错位

一个典型的配置片段长这样：

{  "configurations": [    {      "name": "Python: Current File",      "type": "python",      "request": "launch",      "module": "pytest",      "cwd": "${fileDirname}",      "args": [],      "console": "integratedTerminal"    }  ]}

终端里 cd 一下就能跑，点按钮就失败？这恰好说明了问题所在

这种情况恰恰证明你的代码本身没有任何问题，只是 VSCode 的执行上下文没对齐。除了上面提到的配置，还有几处细节值得留意：

• 确认你没有在「未保存的临时文件」（比如 Untitled-1）里测试——这类文件没有真实路径，${fileDirname} 会解析失败，cwd 只能退回默认值
• 检查文件路径是否包含中文、空格或全角符号——某些 shell 或 Python 版本对这些路径处理不够稳定
• 如果你用的是 WSL，记得从 WSL 环境里用 code . 启动 VSCode，而不是用 Windows 版 VSCode 直接打开 WSL 路径，后者很容易触发跨系统路径的解析异常

这个问题的复杂性，不在于路径写法本身有多难，而在于几个执行入口（Code Runner、调试、终端、任务）各自维持一套 cwd 规则，而且还互不兼容。把 settings.json 和 launch.json 这两处配齐，就能覆盖掉 95% 的情况了。剩下的那 5%，通常就是上面提到的那些边界条件。