便携版Sublime需先创建Data目录才能识别项目;否则退化为普通安装版,导致项目丢失、侧边栏为空、Add Folder失效。Data文件夹须与subl.exe同级且大小写精确,不存在则需手动新建。

便携版必须先建好 Data 目录才能识别项目
Sublime 便携版启动时,会主动查找同级目录下的 Data 文件夹;找不到就退化成普通安装版行为——所有配置写入系统路径,项目添加后可能不保存、重启即丢失。你看到侧边栏空、Add Folder to Project 点了没反应、或项目文件没生成,八成卡在这一步。
确认方式:打开 Sublime 根目录(就是你双击运行 subl.exe 或 sublime_text 的那个文件夹),里面必须有且仅有一个名为 Data 的文件夹(注意大小写,不能是 data 或 DATA)。没有就手动新建一个。
Add Folder to Project 在便携版里失效的常见原因
即使 Data 存在,Add Folder to Project 仍可能点不动或点了没反应,本质是项目上下文没激活。这不是 bug,是便携版对路径注册更敏感:
- 别用
File → Open Folder…直接打开——它会绕过项目机制,只加载单个文件夹,不触发项目状态初始化 - 必须走
Project → Add Folder to Project,且目标文件夹路径不能含中文、空格、特殊符号(比如C:\我的项目\src容易失败,建议先挪到C:\proj\src) - 如果插件已装(如
SideBarEnhancements),但右键菜单里没New Folder…,说明该目录根本没被成功加入项目,不是插件问题 - 便携版执行命令行
subl .有时会失败,因为当前 shell 路径未被正确解析为项目根,此时老实用菜单操作
项目文件(.sublime-project)存哪?怎么让它生效
便携版下,.sublime-project 文件默认保存在你指定的位置,但只有两种情况它才真正“绑定”到当前窗口:
- 你通过
Project → Save Project As…主动保存,且保存后没关闭窗口——此时项目即激活,侧边栏立刻显示所含文件夹 - 你先
Add Folder to Project加了至少一个文件夹,再Save Project As…,生成的.sublime-project里"folders"字段才会包含实际路径(否则可能是空数组或"path": "."这种相对占位) - 项目文件本身不一定要放在项目文件夹内;但如果你希望双击它直接打开对应环境,就得确保
Data目录存在,且 Sublime 是从便携根目录启动的
验证是否生效:打开 Project → Edit Project,看 JSON 里 "folders" 是否列出你加的路径;如果不是,说明添加动作没落库,需重试。
为什么新建的文件夹不显示在侧边栏?
这和“是否是项目一部分”强相关。原生 Sublime 侧边栏只展示已加入项目的目录及其子目录——哪怕你用资源管理器在项目文件夹里手工建了个 src,只要没刷新,它就不会出现。
SideBarEnhancements 插件的 New Folder… 功能能实时创建并显示,但前提是:你右键的那个父目录,本身必须属于当前项目(即它出现在 Project → Edit Project 的 "folders" 列表里)。否则右键菜单压根不显示该选项。
如果已加项目但仍不显示新文件夹,试试 Project → Refresh Folders(快捷键 Ctrl+Alt+R),这是便携版里最常被忽略的同步动作。











