VSCode中“运行单文件”不触发项目上下文，所有配置均来自用户级settings.json；而“运行工作区”（打开文件夹或.code-workspace）才激活.vscode/或工作区级配置，支持调试、任务、扩展等项目级能力。
VSCode 里“运行单文件”和“运行工作区”根本不是同一件事——前者不触发任何项目级上下文，后者才真正激活配置、调试、任务等能力。
单文件打开时，VSCode 做了什么？
直接双击或拖入一个 .py、.js 文件，VSCode 只加载该文件本身，不识别任何父目录结构，也不读取 .vscode/ 或 .code-workspace。此时：
- 所有设置都来自用户级
settings.json，.vscode/settings.json和.code-workspace完全被忽略 -
launch.json、tasks.json、extensions.json一概不生效，调试按钮灰掉，终端默认路径是系统 home 目录 - 扩展启用状态只看全局开关，无法按项目启用/禁用（比如 Prettier 在单文件模式下不会自动格式化）
- 搜索（
Cmd+Shift+F）只在当前文件内进行，不跨行也不跨文件
打开文件夹 vs 打开 .code-workspace：关键区别在哪？
两者都会激活项目上下文，但作用域和能力完全不同：
- 打开文件夹 → 触发“单文件夹工作区”，VSCode 自动把该目录当根，读取其
.vscode/settings.json、.vscode/launch.json等，但仅限这一目录 - 打开
my-project.code-workspace→ 触发“多根工作区”，VSCode 解析folders数组里的所有路径，统一应用settings字段，并允许每个文件夹保留自己的.vscode/launch.json - 如果
.code-workspace中写了"python.defaultInterpreterPath": "/opt/venv/bin/python"，但某个子文件夹的.vscode/settings.json也写了同名键，则后者优先 —— 不是“工作区覆盖文件夹”，而是“文件夹覆盖工作区” - 关闭窗口后，只有
.code-workspace文件能恢复标签页、终端会话和编辑器布局（前提是"window.restoreWindows": "all"已启用）
调试配置 launch.json 为什么有时不出现？
因为 launch.json 的加载完全依赖工作区类型：
- 单文件模式：不加载，调试面板显示 “No Configurations”
- 单文件夹工作区：必须存在
.vscode/launch.json，且内容合法；若该文件夹下没.vscode目录，就等于没有调试配置 - 多根工作区：每个文件夹可自带
.vscode/launch.json，VSCode 会合并列出；但工作区级不能直接写launch字段，只能靠各文件夹自己提供 - 常见错误：
launch.json放错位置（比如放在项目根但没进.vscode/）、JSON 格式有逗号错误、configurations数组为空
什么时候必须用 .code-workspace？
当你需要以下任一能力时，.code-workspace 不是“可选”，而是唯一路径：
- 同时编辑
/src/frontend和/src/backend两个物理上分离的目录，且希望搜索（Cmd+Shift+F）跨两者生效 - 团队要求统一
files.exclude规则，但又不想让每个成员手动改各自项目的.vscode/settings.json - 想为前端项目启用 ESLint，为后端项目启用 mypy，且互不影响 —— 这需要在
.code-workspace中用"extensions": {"recommendations": [...]}+ 各文件夹的.vscode/extensions.json协同控制 - CI/CD 脚本需复现开发环境，
.code-workspace是唯一可提交、可版本化、可自动化加载的配置载体
容易被忽略的一点：VSCode 对 .code-workspace 的解析是静态的——它只认 folders 数组里写的路径，哪怕那个路径当前不存在，也会在资源管理器中显示为灰色“缺失文件夹”，而不会自动跳过或报错。
