vscode 项目快速切换依赖三种方式:一是用 .code-workspace 文件聚合多根项目并保存配置;二是通过“open recent”原生功能零配置切换;三是借助 project manager 插件统一管理与分类项目,配合快捷键提升效率。

VSCode 本身没有“项目管理器”概念,所谓快速切换,本质是让常用路径可复用、可检索、可一键触发——不是靠记忆路径,而是靠 VSCode 记住你。
用 .code-workspace 文件聚合关联项目
多个弱耦合或强协作的项目(比如前端 + 后端、monorepo 中的 packages),适合塞进一个工作区。它不是快捷方式,而是一个带配置的“项目快照”。
-
.code-workspace是 JSON 文件,只记录folders路径和可选的settings,不包含代码或敏感信息,可提交到 Git - 路径尽量用相对路径(如
"./api"),避免硬写/Users/xxx/project/backend,否则换机器就失效 - 保存后双击该文件,或执行
File > Open Workspace from File…,VS Code 会清空当前上下文,完整加载所有文件夹和工作区级settings.json - 注意:多根工作区下,每个根文件夹不能有独立的
.vscode/settings.json—— 它们共享同一个工作区设置,差异化配置得靠扩展或拆成多个工作区
用 Workspaces: Open Recent 切换最近打开的项目
这是最轻量、零配置的切换方式,适合频繁跳转完全无关的项目(比如同时维护客户 A 的 React 项目和客户 B 的 Python 工具)。
- 按
Ctrl+Shift+P(macOS 为Cmd+Shift+P),输入Workspaces: Open Recent,列表里会同时出现最近打开的文件夹和.code-workspace文件 - 列表支持模糊搜索:输入
react或py就能过滤出匹配项;鼠标悬停还能预览完整路径,防手滑点错 - 默认不固定条目,但你可以右键某项目 → “Pin to Top”,把它钉在列表最上面,变成常驻入口
- 这个列表由 VSCode 自动维护,不需要手动注册,关机重启也不丢
用 Project Manager 插件统一登记并分类项目
当你项目数超过 10 个,或者需要按客户/类型/状态做分组时,原生功能开始吃力,Project Manager 就成了刚需。
- 安装后必须手动执行
Project Manager: Save Project才会把当前打开的文件夹存进插件库——它不会自动扫描硬盘 - 保存时给项目起名要唯一且带语义,比如
client-x-admin-fe比admin更容易区分,避免后期搜索冲突 - 调用时用
Project Manager: List Projects,支持关键词匹配、方向键导航、回车新开窗口(默认行为),也可在设置里改成“在当前窗口打开” - 插件生成的
projects.json默认存在用户数据目录,跨设备同步需手动备份,别指望它自动上云
绑定快捷键绕过命令面板输指令
重复操作一旦超过 3 次,就值得配快捷键。高频动作包括:打开最近工作区、唤出项目列表、直接打开某个固定路径。
- 在
keybindings.json里加一条:{"key": "ctrl+alt+w", "command": "workbench.action.QuickOpenRecent", "args": {"type": "workspace"}},就能一键呼出最近工作区(不含普通文件夹) - 想直通 Project Manager,配
{"key": "ctrl+alt+p", "command": "project-manager.listProjects"},比输命令快一个数量级 - 如果某个项目天天开,可用
vscode.openFolder绑定绝对路径:{"key": "ctrl+alt+1", "command": "vscode.openFolder", "args": {"folder": "/path/to/my-main-project", "forceNewWindow": true}} - 注意:含空格或中文路径要用双引号包裹,且
forceNewWindow: true可避免覆盖当前窗口,但会多占一个进程
真正卡住人的往往不是功能找不到,而是路径写死、插件没手动存项目、快捷键配了却忘了重启 VSCode —— 这些细节不处理,再好的机制也白搭。











