便携版生效的唯一条件是sublime_text.exe同级目录存在严格命名为“Data”的文件夹；启动后所有配置存于Data\Packages等子目录，验证路径须通过Preferences→Browse Packages…确认指向Data目录。
便携版生效的唯一路径条件：同级目录必须存在 Data 文件夹
Sublime Text 不靠参数、不靠注册表、不靠安装器识别便携模式——它只认一个东西：Data（首字母大写，其余小写，不能是 data、DATA 或带空格/下划线的变体）。这个文件夹必须和 sublime_text.exe（Windows）或 sublime_text（macOS/Linux）处于同一级目录。一旦缺失或命名错误，它立刻退回到系统默认路径写配置，U 盘一拔，所有设置全丢。
常见错误包括：
- 把
Data建在子目录里（比如SublimeText/bin/Data），Sublime 找不到 - 解压官网 ZIP 后直接双击运行，没先建
Data，首次启动已把配置写进%APPDATA% - 用第三方“便携包”，里面
Data被重命名或藏在奇怪位置
Preferences → Browse Packages… 是唯一可信路径验证方式
别信网上搜来的默认路径，也别靠记忆拼 %APPDATA%\Sublime Text\Packages 或 ~/Library/Application Support/Sublime Text/Packages。这些只是常规安装的默认值，便携版下完全无效。真正起作用的路径，永远是菜单项 Preferences → Browse Packages… 弹出的文件管理器地址。
如果弹窗显示的是类似 D:\Tools\SublimeText\Data\Packages，说明便携生效；如果显示 C:\Users\XXX\AppData\Roaming\Sublime Text\Packages，说明你还在系统模式下跑。
验证时注意：
- 必须在 Sublime 启动后操作，未启动时该菜单可能灰掉
- 首次建好
Data后要重启 Sublime，否则菜单仍指向旧路径 - macOS/Linux 下路径含空格或特殊字符（如
Application Support），手动拼写极易出错
插件和配置实际落盘位置：不是 Installed Packages，而是 Packages 和 Data 根目录
很多人以为插件装进 Installed Packages 就完事了，其实不是。Sublime 运行时只加载 Packages 目录下的内容：User、Default、插件名文件夹都得在这里。而 Installed Packages 只存 .sublime-package 压缩包，是 Package Control 安装时的中转站，不是运行目录。
所以手动部署时：
- GitHub 下载的插件 ZIP，要解压后整体扔进
Data\Packages\插件名（不是Installed Packages） -
Preferences.sublime-settings等用户配置，必须放在Data\Packages\User\下 - 主题、配色方案等资源，也要放进
Data\Packages\对应子目录，不能只放压缩包 - 如果插件装了但不生效，先检查
Data\Packages\里有没有对应文件夹，而不是看Installed Packages
跨平台同步时最容易忽略的三个点
便携版同步的本质是同步整个 Data 目录，但实操中常因细节翻车：
- Windows 和 macOS/Linux 的换行符、文件权限、隐藏文件（如
.DS_Store）可能干扰同步工具，建议用 rsync 或 Rclone，避免用 Windows 资源管理器直接复制 -
Data\Local存缓存和会话状态，包含机器相关路径（如临时文件绝对路径），不同电脑间不要强制覆盖，可选择性跳过 - 某些插件（如 GitGutter、SideBarEnhancements）会在首次运行时生成本地索引或绑定路径，迁移后需在新机器上重启 Sublime 并触发一次手动刷新（比如右键侧边栏 → “Refresh Folder”）
最稳的做法：每次只同步 Data\Packages 和 Data\Installed Packages，其他子目录按需处理。同步前确认目标机上 Data 已存在且大小写正确——这是整个便携逻辑的起点，也是最容易被忽略的起点。
