VSCode工作区比多窗口更可靠，因多窗口下Ctrl+Click无法跨窗跳转、Go to Definition找不到跨项目符号，而工作区将多个文件夹合并为逻辑项目，使TypeScript/Python等语言服务能跨目录索引。
为什么 VSCode 的 workspaces 比多窗口更可靠
直接开多个 VSCode 窗口管理不同项目，路径跳转会失效——比如 Ctrl+Click 进不到另一个窗口的文件里，Go to Definition 也找不到跨项目的符号。用 workspaces（工作区）才是正解：它把多个文件夹合并成一个逻辑项目，让 TypeScript、Python 插件、IntelliSense 全部能跨目录索引。
操作很简单：File → Add Folder to Workspace…，选中你要并入的项目根目录；之后保存为 .code-workspace 文件。注意别直接用 File → Open Folder，那只是单文件夹模式，不支持跨路径解析。
-
.code-workspace是 JSON 文件，可手动编辑folders数组增删路径，但必须是绝对路径或相对于该文件的相对路径 - 如果某个子项目用了
pnpm或npm workspaces，确保它的package.json在 workspace 的folders列表里，否则类型定义不会被识别 - 插件如
ES7+ React/Redux/React-Native snippets不受 workspace 影响，但语言服务器类（如Python、eslint、typescript-language-server）依赖 workspace 配置才能跨文件夹生效
Quick Switcher 插件真能秒切项目？
装了 Quick Switcher（作者：brunnerh）后，按 Ctrl+P 再输 >，会出现 Switch Workspace 命令。但它只列出最近打开过的 .code-workspace 文件——不是所有文件夹，也不是你硬盘上任意路径。
想让它“秒切”，得提前把常用项目存成 workspace 文件，并放在固定位置（比如 ~/code/workspaces/），然后用 VSCode 设置里的 workbench.startupEditor 设为 none，避免每次启动都加载默认文件夹干扰切换。
- 插件不支持模糊匹配路径名，只能匹配 workspace 文件名（如
frontend.code-workspace输入front就能出来） - 如果 workspace 里某个文件夹路径已不存在，切换时会报错
Unable to open 'xxx': File not found，需手动编辑.code-workspace删除无效条目 - 和系统级快捷键冲突常见：比如
Alt+Tab和插件默认的Alt+W切换热键，建议在keybindings.json里重映射为Ctrl+Shift+W
路径跳转失效？先查 "typescript.preferences.importModuleSpecifier"
即使开了 workspace，从 A 项目 import B 项目的模块时，VSCode 仍可能提示 “Cannot find module”，或者自动补全只给出相对路径（../../utils/helper）而不是 workspace-aware 的包路径（@shared/utils）。问题常出在 TypeScript 的导入策略配置上。
在 workspace 根目录下建 tsconfig.json，确保含 compilerOptions.baseUrl 和 paths，例如：
{
"compilerOptions": {
"baseUrl": ".",
"paths": {
"@shared/*": ["../shared/src/*"]
}
}
}
然后在 VSCode 设置里搜 typescript.preferences.importModuleSpecifier，设为 non-relative。否则 TS 语言服务会坚持用 ../，VSCode 的跳转就找不到目标。
- 这个设置只影响新生成的 import 语句，已有代码不会自动重写
- 如果 workspace 中多个项目共用一套
paths，务必统一baseUrl，否则路径解析会错乱 - VSCode 的
Restart TS Server命令（Ctrl+Shift+P→ 输入该命令）比重启窗口更快生效
Python 项目间跳转卡住？检查 python.defaultInterpreterPath
Python 插件默认只认当前打开文件夹下的 venv 或 pyenv，跨 workspace 时经常找不到其他项目的解释器，导致 Go to Definition 失效、linting 报错、甚至 import 行标红。
解决办法不是全局设 interpreter，而是为每个 workspace 单独配。打开命令面板（Ctrl+Shift+P），运行 Python: Select Interpreter，再选中对应项目下的 venv/bin/python（macOS/Linux）或 venv\Scripts\python.exe（Windows）。VSCode 会把这个路径写进 workspace 的 .vscode/settings.json 里。
- 别用
python.defaultInterpreterPath用户级设置，它会覆盖 workspace 级配置，造成跳转混乱 - 如果项目用了
poetry，确保已执行poetry install，且 VSCode 显示的 interpreter 路径指向poetry env info --path输出的目录 - 某些旧版
Pylance不支持跨 workspace 的 stubs 解析，升级到 v2023.10+ 可修复
真正麻烦的不是怎么切，而是切完之后语言服务是否真正“看见”了所有路径——这取决于 workspace 结构、TS/Python 配置、以及插件版本三者是否对齐。少一个环节，跳转就断在半路。
