sublime text便携版启动必须用--data参数指定data目录;官网zip包解压后需在同级新建严格命名为data的文件夹,路径含空格或中文时须加英文双引号,首次启动后通过preferences→browse packages…确认路径为data\packages。

便携版启动时必须用 --data 参数指定 Data 目录
Sublime Text 没有“绿色版安装包”,所谓免安装,本质是绕过系统路径写入,靠 --data 参数强制接管所有用户数据。不加这个参数,哪怕你解压的是官网 ZIP 包,它也会默认往 %APPDATA%\Sublime Text(Windows)或 ~/Library/Application Support/Sublime Text(macOS)写配置——这不是便携,只是没装注册表而已。
正确做法:解压官网 Sublime Text Build 4162 x64.zip 后,在同级目录下新建一个空文件夹,名字严格为 Data(首字母大写,不能是 data 或 DATA),然后用命令行启动:sublime_text.exe --data "D:\my-portable-sublime\Data"(Windows)或./sublime_text --data "/Users/me/sublime-portable/Data"(macOS/Linux)
- 路径含空格或中文时,
--data后的值必须用英文双引号包裹 - 首次启动后,检查菜单 →
Preferences → Browse Packages…,路径必须显示为Data\Packages,否则说明参数没生效或Data文件夹位置错了 - 别信第三方打包的“便携版”,它们常偷偷写注册表或调用系统缓存路径,破坏真正便携性
项目空间(Project)路径与便携版 Data 目录无关
项目空间不是配置项,而是 Sublime 的上下文机制。它不存于 Data 目录里,也不受 --data 影响;它只取决于你当前打开的文件夹和保存的 .sublime-project 文件位置。
想让新文件默认保存到某路径?不能改全局设置,只能靠项目绑定:
- 先用
File → Open Folder…打开你的目标项目根目录(比如D:\work\my-api) - 再按
Ctrl+N新建文件,Ctrl+S时对话框会自动定位到该文件夹 - 点击
Project → Save Project As…,把.sublime-project文件存到项目根目录下(如D:\work\my-api\my-api.sublime-project) - 以后双击这个项目文件,就自动加载路径上下文、排除规则、缩进设置等全部配置
注意:hot_exit 和 remember_open_files 若开启,可能让未保存的 untitled 标签页跨会话残留,从而绕过项目路径——建议在 Preferences → Settings – User 中显式关闭这两项。
Git stash 暂存区路径由 Git 仓库决定,与 Sublime 无关
Sublime Text 本身不管理 Git 暂存区(staging area)或工作区(working directory)路径。stash 操作完全依赖 Git 插件调用系统 Git 命令,所以它的行为和路径逻辑和你在终端里执行 git stash 完全一致。
关键前提只有两个:
- 当前 Sublime 窗口必须打开的是 Git 仓库根目录(即包含
.git文件夹的目录),不是子目录 - Git 插件已安装且启用(
Preferences → Package Settings → Git → Enable)
执行 Ctrl+Shift+P → Git: Stash 后,Sublime 调用的是 git stash push -m "",所有暂存内容都存在 Git 仓库的 .git/refs/stash 及相关对象中,和 Sublime 的 Data 目录或项目文件完全隔离。
容易被忽略的一点:Git 插件不会自动刷新状态栏分支标记(如右下角的 main*)。stash 后即使工作区干净了,星号可能还在——得手动右键 → Git → Refresh Status,或者重新加载文件夹。
插件与配置的实际落点必须通过 Browse Packages… 确认
别靠记忆拼路径。便携版下,插件实际加载位置是 Data\Packages,但有人误以为是 Data\Installed Packages,结果手动丢错地方导致插件不生效。
真实分工:
-
Installed Packages:只放.sublime-package压缩包(Package Control 下载后自动解压到这里) -
Packages:运行时加载的位置,里面是解压后的文件夹(如Packages/GitGutter/),手动安装源码必须放这里
验证方式永远只有一种:Preferences → Browse Packages…。它弹出的窗口地址就是当前生效的真实 Packages 目录——无论你是 Windows/macOS/Linux,也无论 ST3/ST4,甚至 Snap/Flatpak 用户,这个入口永远准确。
迁移便携版时,只要把整个 Data 文件夹复制走,Packages、Installed Packages、Local 全在里面,换电脑解压 + 正确 --data 参数就能立刻复原,不用重装插件或重配设置。











