VSCode 运行代码找不到文件主因是当前工作目录（cwd）与脚本所在目录不一致，尤其在多根工作区、单文件打开或调试时，open()等相对路径默认基于窗口根目录而非__file__所在目录；需在launch.json中显式配置cwd字段（如"${fileDirname}"或"${workspaceFolder}"）并确保置于对应子项目.vscode/下。
VSCode 运行代码时找不到文件，90% 不是代码问题，而是当前工作目录（cwd）和你预期的不一致——尤其在多根工作区、子文件夹打开、或调试 Python/Node.js 脚本时，__file__、require()、open("config.json") 这类相对路径会直接失效。
为什么 open("data.txt") 报错 FileNotFoundError
VSCode 默认以「窗口打开的根目录」为工作目录，不是你当前编辑的文件所在目录。比如你双击打开了 src/utils/helper.py，但窗口根目录是 /project，那么 open("data.txt") 就会去查 /project/data.txt，而不是 /project/src/utils/data.txt。
- 验证当前
cwd：在终端里运行pwd，输出的就是 VSCode 当前认定的工作目录 - 单文件打开（没以文件夹方式打开）→
cwd是用户主目录或临时路径，极不稳定 - 多根工作区（
.code-workspace）→cwd默认是第一个folders[0]的路径，不是你正在编辑的文件夹 - 调试时更危险：launch.json 里没配
cwd字段，就继承窗口级cwd，和你想象的几乎总不一致
launch.json 必须显式设 cwd 才可靠
别依赖默认值。只要脚本里用了相对路径，launch.json 就得写死 cwd。位置也很关键：它必须放在对应子项目的 .vscode/launch.json 里，而不是工作区根目录的 .vscode/ 下。
- 对单个项目（如
backend/）：在backend/.vscode/launch.json中写"cwd": "${workspaceFolder}" - 想让每个文件都以自身目录为起点：用
"cwd": "${fileDirname}"（推荐用于工具脚本） - 跨子项目调试（如前端调后端 API）：用命名占位符，例如
"cwd": "${workspaceFolder:server}"，前提是.code-workspace的folders里已定义了"server"这个名称 - 绝对别写
"cwd": "./server"或"./backend"—— VSCode 不解析相对路径，会静默失败
工作区设置三层优先级，搞错就白配
VSCode 设置不是“一套配置走天下”，而是有明确覆盖顺序：.vscode/settings.json（文件夹级） > .code-workspace 里的 settings（工作区级） > 用户设置。但这个优先级只对「同名字段」生效，且不同场景加载逻辑完全不同。
-
python.defaultInterpreterPath这种强路径项，必须写在对应子项目的.vscode/settings.json里，写在.code-workspace里大概率找不到解释器 -
files.exclude和search.exclude是两套独立配置：前者控制资源管理器是否显示文件夹，后者控制全局搜索范围，漏配一个就会“找不到” - 多根工作区下，
.vscode/settings.json在子文件夹里依然有效，且优先级高于工作区settings；但如果你把所有设置都堆进.code-workspace，反而会掩盖子项目的定制需求 - 改完
settings.json后，部分设置（如editor.tabSize）实时生效，但像eslint.enable这类插件开关，需要重启窗口或重载窗口（Developer: Reload Window）才起作用
怎么确认当前到底在哪个工作区上下文
别猜。VSCode 窗口右下角状态栏显示 [Workspace] 才算真正进入了工作区上下文；如果只显示文件名或 [Folder]，说明你只是打开了单个文件夹，.code-workspace 根本没加载。
- 快捷验证法：按
Ctrl+Shift+P（macOS 是Cmd+Shift+P），输入Developer: Toggle Developer Tools，在 Console 里粘贴执行：vscode.workspace.workspaceFolders—— 返回null就是没进工作区 - 检查标题栏：启用
"window.title": "${filePath} - ${rootName}"后，若${rootName}为空，说明没识别到任何根目录 - 命令行打开必须精准：
code /path/to/my-project.code-workspace有效；code /path/to/my-project/backend会丢失整个工作区结构 - 拖拽多个文件夹进空窗口 ≠ 创建工作区，只是临时视图，关掉就丢 —— 唯一持久化动作是
File > Save Workspace As…
最易被忽略的一点：VSCode 对路径是“认死理”的。.code-workspace 文件里写的绝对路径，换机器、挪目录就立刻失效；而相对路径虽可移植，但要求所有成员把 .code-workspace 放在统一父目录下，稍有偏差，${workspaceFolder:client} 这类变量就解析失败。实际协作中，宁可接受手动更新路径，也别指望自动映射。
