ProjectManager 插件需手动完成三件事:安装Package Control、将.sublime-project文件放入Packages/User/Projects/或导入、启用close_windows_on_project_switch;否则切换项目时标签残留、路径失效、列表为空属正常行为。

ProjectManager 插件不能直接“装完就用”,必须手动补全三件事:Package Control 已就位、.sublime-project 文件已导入或放对位置、close_windows_on_project_switch 需显式开启——否则切换项目时标签残留、路径失效、列表为空全是预期行为,不是插件坏了。
Package Control 没装好,ProjectManager 根本不会出现
按 Ctrl+Shift+P(macOS 是 Cmd+Shift+P)后搜不到 Install Package,说明 Package Control 没生效。这不是 ProjectManager 的问题,是前置依赖缺失。
- 按
Ctrl+`打开 Sublime 控制台,粘贴官方 Python 3.8+ 兼容安装脚本(注意别用旧版) - 执行后不要关窗口,必须重启 Sublime —— 有些版本不重载插件系统,命令面板里依然看不到
Package Control:前缀命令 - 验证方式:再次呼出命令面板,输入
Package Control:,能看到一长串以它开头的命令才算成功
.sublime-project 文件没被识别,列表永远为空
装完插件按 Ctrl+Alt+P(Windows/Linux)或 Cmd+Alt+P(macOS)发现面板空空如也,是因为 ProjectManager 默认只扫描 Packages/User/Projects/ 目录,不会自动找你硬盘上散落的 .sublime-project 文件。
- 把已有项目文件复制进
Packages/User/Projects/,再运行Project Manager: Refresh Projects - 或先用 Sublime 打开某个
.sublime-project文件,再执行Project Manager: Import Project—— 它会记录路径并加入列表 - 注意:Import 后会把
folders字段写成绝对路径,团队共享时得手动改成相对路径或用${project_path}变量
切换项目后旧标签还在,是因为 workspace 复用
按 Ctrl+Alt+P 切换后,上个项目没保存的标签、分屏布局甚至终端工作目录还留着,这不是 bug,是 Sublime 原生 project_open 的默认行为。
-
Project Manager: Switch Project只替换项目配置,不清理窗口状态 - 真正隔离的方式是
Project Manager: Open Project in New Window,但效率低 - 想“切换即清空”,必须在
project_manager.sublime-settings里加这一行:"close_windows_on_project_switch": true
多个微服务项目互相干扰?一个窗口加多个文件夹是根源
用 Project → Add Folder to Project… 把 frontend 和 backend 都塞进同一个 .sublime-project,会导致构建系统、tab_size、ESLint 配置全局冲突——因为所有文件夹共享同一套 settings 和插件上下文。
- 正确做法是每个微服务单独保存为独立
.sublime-project,且放在各自根目录下(推荐"path": ".") - 切换时用命令行启动新窗口:
subl --new-window /path/to/my-frontend(macOS/Linux)或"C:\Program Files\Sublime Text\subl.exe" --new-window "D:\my-backend"(Windows) - 确保
subl已加入 PATH;macOS 使用 Snap 安装时--new-window可能被沙盒拦截,建议换 tarball 版本
最容易被忽略的是:ProjectManager 不接管 workspace 行为,也不校验路径有效性。它只是个跳转器,路径失效、JSON 格式错、跨磁盘挂载点变更,都会导致 File not found 报错——得靠 Project Manager: Clean Projects 主动剔除无效条目,而不是等它自己发现。


















