VSCode报“工作区文件夹不存在”主因是路径记录失效，常见于文件夹被移动、重命名或删除；需检查右下角路径真实性，排查launch.json、settings.json及.code-workspace中硬编码路径，并优先用File>Open Folder刷新引用。
VSCode 报“工作区文件夹不存在”，不是项目丢了，而是它找不到打开时记录的物理路径——最常见原因是文件夹被移动、重命名或彻底删除了。
检查当前工作区根路径是否真实存在
VSCode 窗口右下角显示的路径就是它认定的 workspaceFolder。复制这个路径，直接粘贴到文件管理器或终端里执行 ls（macOS/Linux）或 dir（Windows），看目录是否存在。
- 如果返回
No such file or directory或 “系统找不到指定路径”，说明该文件夹确实不在原处了 - 如果路径中包含中文、空格或特殊符号（如
【项目】v2），某些扩展或旧版 VSCode 可能解析失败，建议临时改用纯英文路径测试 - Windows 用户特别注意大小写：虽然系统不敏感，但 VSCode 的文件监视器（尤其是 WSL 场景）可能因大小写不一致判定路径无效
修复或重建工作区的三种方式
不要直接删掉整个 .vscode 文件夹——里面可能有 launch.json、tasks.json 等关键调试配置。
- 若文件夹只是被移动：把整个文件夹拖回原路径，或右键资源管理器空白处 → Reveal in Explorer 看能否跳转；不行就关掉 VSCode，手动修改
settings.json里的terminal.integrated.cwd和任何硬编码路径 - 若文件夹已重命名：在 VSCode 中执行 File > Close Folder，再用 File > Open Folder 重新选中新名字的文件夹——这会刷新所有内部路径引用
- 若文件夹已删除且无备份：只能新建工作区。点击 File > Save Workspace As…，保存为
myproject.code-workspace；之后在该文件上右键 → Open with Code，确保后续都通过这个文件启动
为什么改了路径还是报错？重点查这几个地方
即使你确认文件夹存在，VSCode 仍可能因上下文错位继续报错。问题往往藏在这些配置里：
-
launch.json中的program字段用了绝对路径（比如"C:\old\path\main.py"），而实际文件已在新位置——统一改用${workspaceFolder}变量 -
settings.json（用户级或工作区级）里写了死路径，例如"python.defaultInterpreterPath": "C:\old\venv\Scripts\python.exe" - 用了多根工作区（
.code-workspace），但其中某个子文件夹路径字段指向了已失效的目录，打开该文件用文本编辑器检查"folders"数组里的"path"值 - 远程开发（SSH/WSL）场景下，本地 VSCode 记录的是远程路径（如
/home/user/project），但远程服务器上该路径已被清空或权限变更——需登录服务器验证ls -ld /home/user/project
真正麻烦的不是路径本身，而是 VSCode 在多个层级（窗口状态、设置文件、调试配置、远程会话）里分散保存了路径快照。一个地方没同步，就会反复触发“不存在”提示。动手前先看右下角路径，再查 launch.json 和 .code-workspace 文件内容，比盲目重启或重装高效得多。
