Package Control未安装导致ProjectManager无法使用，根本原因是命令面板搜不到“Package Control: Install Package”，需先通过控制台执行适配版本的官方脚本、重启Sublime并验证命令存在；ProjectManager项目列表为空则因默认仅扫描Packages/User/Projects/目录，需手动复制.sublime-project文件或使用Import Project导入。
Package Control装不上，ProjectManager根本动不了
ProjectManager插件依赖Package Control，但很多人卡在第一步：按Ctrl+Shift+P（macOS是Cmd+Shift+P）后搜不到Install Package。这不是ProjectManager的问题，而是Package Control没真正就位。
验证方式很简单：打开命令面板，输入Package Control:，能看到一长串以它开头的命令才算成功。如果没出现：
- 按
Ctrl+`调出Sublime控制台，粘贴官方Python安装脚本（注意Sublime Text 4已默认用Python 3.8+，旧脚本可能失效） - 回车执行后别急着关窗口，必须重启Sublime——部分版本不重启不会加载新插件系统
- Windows用户若曾禁用UAC或装在非标准路径，可能需右键“以管理员身份运行”一次再重试
装完ProjectManager，项目列表却是空的
ProjectManager默认只扫描Packages/User/Projects/目录下的.sublime-project文件，不会自动发现你硬盘上已有的项目文件。直接按Ctrl+Alt+P（macOS是Cmd+Alt+P）看到空列表，是正常现象，不是插件坏了。
补救方法只有两种，选一个就行：
- 把已有
.sublime-project文件手动复制到Packages/User/Projects/，然后执行Project Manager: Refresh Projects - 先用Sublime打开任意一个
.sublime-project文件，再运行Project Manager: Import Project——它会记录路径并加入列表
注意：Import Project会把folders字段改写成绝对路径，团队协作时得手动替换成${project_path}变量，否则别人拉代码后路径失效。
切换项目后旧标签还在，workspace没清干净
按Ctrl+Alt+P切换项目，发现前一个项目的未保存文件、分屏布局甚至断点还留在当前窗口——这不是bug，是Sublime原生project_open行为：复用当前workspace。
想做到“切换即清空”，必须改配置：
- 打开
Preferences → Package Settings → ProjectManager → Settings - 在用户设置里加一行：
"close_windows_on_project_switch": true - 这个选项默认是
false，不手动开，ProjectManager就只管跳转，不管清理
另外，Project Manager: Open Project in New Window才是真隔离，适合需要并行调试多个项目的场景。
大型项目里.sublime-project文件怎么写才靠谱
手动生成项目文件不能只靠Project → Save Project As…，尤其当项目含多级子模块或需跨平台共享时，硬编码路径和忽略规则很容易翻车。
关键字段要留心：
-
folders里优先用${project_path}代替绝对路径，比如"path": "${project_path}/src" -
settings下加"tab_size": 2这类语言无关配置可以生效，但"syntax"之类得靠Syntax Specific单独设 -
file_exclude_patterns和folder_exclude_patterns别写错格式，漏掉逗号或引号会导致整个项目文件加载失败，Sublime日志里会报error parsing project file
最常被忽略的是build_systems字段——它不继承全局设置，每个项目得自己定义，否则按Ctrl+B会找不到构建命令。
