免安装版sublime text的便携模式依赖同级且首字母大写的data文件夹,项目配置由同名.sublime-project文件定义,.sublime-workspace自动生成不可手动干预,新建文件默认保存路径由已加载项目的"folders"决定。

免安装版的 Data 文件夹必须与 sublime_text.exe 同级且严格命名为 Data
Sublime Text 的便携模式不是靠“绿色补丁”触发的,而是依赖一个叫 Data 的空文件夹——名字必须是首字母大写的 Data(不能是 data、DATA 或带空格),且必须和 sublime_text.exe(Windows)或 sublime_text(macOS/Linux)在同一级目录下。第一次启动后,所有插件、设置、缓存都会自动写入 Data/Packages/、Data/Installed Packages/ 等子目录。
验证是否生效:菜单 → Preferences → Browse Packages…,路径应显示类似 D:\sublime-portable\Data\Packages。如果指向 %APPDATA%\Sublime Text 3\Packages,说明 Data 文件夹位置或命名错了。
- 路径含中文或空格时,启动命令中必须用英文双引号包裹,例如:
sublime_text.exe -data "D:\我的便携版\Data" - 不要把
Data建在子目录里(比如D:\sublime\Data是对的,D:\sublime\bin\Data就无效) - macOS/Linux 用户注意大小写敏感:
Data不能写成data
.sublime-project 文件必须放在项目根目录,且文件名要与文件夹名一致
免安装版不改变项目配置逻辑——.sublime-project 仍是唯一有效的项目定义文件,它必须放在你实际想管理的项目根目录下,且推荐命名为 myproject.sublime-project(即与文件夹名一致)。Sublime 不会读取项目外的 project 文件,也不会识别错位存放的同名文件。
常见错误:把 myapp.sublime-project 放在 D:\projects\ 下,而项目实际在 D:\projects\myapp\。这时 Sublime 加载项目后,"folders": [{ "path": "." }] 指向的是 D:\projects\,而非 myapp 子目录。
-
"path"字段支持相对路径,基准点永远是.sublime-project所在位置,不是当前打开窗口的位置 - Windows 下路径分隔符用
/或\都可以,但别混用(如src\js/main.js和src/js/main.js不能同时出现在同一配置中) - 修改 project 文件后,必须关闭项目再重新打开:菜单 → Project → Close Project,再 → Project → Open Project… 选中该
.sublime-project
项目工作区状态(.sublime-workspace)无法手动控制存放位置
.sublime-workspace 文件是 Sublime 自动生成的二进制快照,记录光标位置、折叠状态、已打开标签等运行时信息,**不能也不该被移动或重定向**。它总和 .sublime-project 同名、同目录生成,比如 myapp.sublime-project 对应 myapp.sublime-workspace。
你无法通过配置让 workspace 存到 Data 目录下,也不该尝试编辑它——它是校验过的二进制 JSON,手动改会导致下次启动时被覆盖或报错 error parsing project。
- Git 项目中应将
*.sublime-workspace加入.gitignore,只提交.sublime-project - 双击
.sublime-workspace文件只会恢复上次窗口状态,不会加载 project 配置;正确入口永远是.sublime-project - 如果误删了 workspace,重启 Sublime 并打开 project 后会自动生成新的,不影响 project 功能
默认保存路径只能靠项目机制“引导”,不能硬设
免安装版依然没有 default_save_path 这类全局配置项。新建文件(Ctrl+N)首次保存(Ctrl+S)时,对话框默认位置由当前激活的 project 决定:如果已打开 myapp.sublime-project,且其中 "folders" 包含 "path": "src",那么保存对话框就会定位到 src/ 目录下。
没激活 project 时,Sublime 默认跳转到系统文档目录(如 Windows 的 Documents),这个行为无法修改,但可通过以下方式规避:
- 始终先用 Project → Open Project… 加载
.sublime-project,再新建文件 - 关闭
"hot_exit": true和"remember_open_files": true(在Packages/User/Preferences.sublime-settings中设置),避免未命名文件残留干扰路径上下文 - 不要在 Preferences → Settings – User 里加任何未被官方文档收录的字段(如
save_dialog_default_directory),它们完全无效
"folders" 结构和是否正确加载它。其他所有“设默认路径”的尝试,最终都绕不开这一步。











