ProjectManager 是 Sublime Text 唯一真正支持磁盘索引、模糊搜索与自动刷新的项目管理方案；原生 Project 功能不扫描磁盘、不更新路径、不支持关键词查找，且 Switch Project 仅记录手动加载的项目文件，无法识别已删除、移动或中文命名的项目。
ProjectManager 是 Sublime Text 唯一能真正索引、搜索、自动刷新项目列表的靠谱方案；原生 Project 功能不扫描磁盘、不更新路径、不支持模糊查找，实际用起来基本等于没项目管理。
为什么原生 Switch Project（Ctrl+Alt+P）总切不到你要的项目
原生 Project: Switch Project 命令只记录「你手动通过 Project → Open Project 加载过的 .sublime-project 文件」，不是所有磁盘上存在的项目文件。它不扫描目录，不刷新已删除/移动的路径，点进去常报错：Unable to open project: path does not exist。中文项目名还容易乱码，且无法按关键词过滤——比如搜 “vue” 找不到 my-vue-app.sublime-project。
常见错误现象：
- 保存了项目却在快捷键列表里看不到
- 重命名或移动项目文件夹后，再点列表项直接报错
- 误以为“最近打开的文件夹” = “最近保存的项目”，其实两者完全无关
安装后必须做的三件事，否则插件形同虚设
ProjectManager 默认不自动发现你硬盘上已有的 .sublime-project 文件，必须手动触发注册。
- 首次保存项目，必须用命令面板执行
Project Manager: Save Project（不是原生的Project → Save Project As…），否则文件会随便存到桌面或下载目录，插件默认不扫描 - 已有项目文件在源码目录下（如
backend/backend.sublime-project），需先运行Project Manager: Refresh Projects，再右键插件界面 →Import Project指向它 - 确保插件配置中
"projects_folder"指向有效路径（默认是Packages/User/Projects/），别留空或填错斜杠
Quick Switch Project 和 Open Project in New Window 的本质区别
这两个命令对应完全不同的工作流，选错会导致标签页丢失或上下文混乱。
-
Project Manager: Quick Switch Project（默认Ctrl+Alt+P）：关闭当前所有标签页，加载目标项目的全部文件 + 上次关闭时的标签页和光标位置。适合彻底切换技术栈，比如从 Python 后端切到 Vue 前端 -
Project Manager: Open Project in New Window：新开一个 Sublime 窗口，完全隔离。适合并行开发，比如一边改 API 接口定义，一边调前端页面 - 千万别用
Project → Add Folder to Project…来“模拟多项目”——它只是把另一个目录塞进当前.sublime-project，所有设置、构建系统、排除规则都混在一起，Ctrl+Shift+F全局搜索会扫到你不想要的目录
项目文件路径写相对还是绝对？怎么避免换机器失效
在 .sublime-project 的 "folders" 字段里，"path" 强烈建议用相对路径（如 "." 或 "src"），而不是绝对路径（如 /Users/name/project/src）。ProjectManager 导入或刷新时会自动补全为相对于项目文件所在目录的路径。
容易被忽略的关键点：
- 如果项目文件放在源码根目录（如
myapp/myapp.sublime-project），"path": "."就能保证跨机器、跨用户可移植 - 手动编辑 JSON 时，别加空对象或拼错字段名（如写成
"folder_exclude_pattern"少了个 s），整个folders条目会被跳过，侧边栏变空 -
folder_exclude_patterns只影响侧边栏显示，不影响Ctrl+Shift+F搜索范围——后者仍会扫被 exclude 的目录，真要过滤搜索得靠插件如FileDiffs或自定义构建命令
