Sublime Text 便携模式生效的前提是启动时根目录存在严格命名为“Data”的文件夹；否则配置、插件均写入系统路径导致失效。
便携版启动前必须存在 Data 文件夹
Sublime Text 是否进入便携模式，只看一件事：启动时根目录下有没有严格命名为 Data 的文件夹（首字母大写，其余小写，不能是 data、DATA 或 MyData）。它必须和 sublime_text.exe（Windows）或 sublime_text（macOS/Linux）在同一级目录，不能嵌套在子文件夹里。
常见错误现象：
- 首次运行后，
Preferences → Browse Packages…路径指向%APPDATA%Sublime Text 3Packages（Windows）或~/Library/Application Support/Sublime Text/Packages（macOS），说明便携失效 - 插件装完重启就消失，配置改了下次打开还原——全因数据没写进你期望的本地目录
实操建议：
- 解压官网
.zip包后，手动在根目录新建空文件夹，名字必须是Data - 如果已误启动过，先删掉系统路径下的对应目录（如 Windows 的
%APPDATA%Sublime Text 3），再补建Data并重启 - 验证是否成功：菜单 →
Preferences → Browse Packages…，路径末尾必须是/Data/Packages
Package Control 安装失败，大概率不是网络问题
控制台执行安装脚本后无反应、报错、或重启后找不到 Package Control 命令，90% 是因为 Data 没生效，导致 sublime.installed_packages_path() 返回的是系统路径，插件被装到别处去了。
实操建议：
- 确认
Data已存在且路径正确后，再执行安装脚本；老教程里的 Python 2 脚本（含urllib2）已彻底失效，必须用支持 Python 3.3+ 的新版（含urllib.request和 SHA256 校验） - 若提示
Error validating download，说明下载内容哈希不匹配——不是脚本错了，而是被代理/防火墙篡改或缓存污染；此时应手动下载Package Control.sublime-package，放进Data/Installed Packages/目录再重启 - 安装后检查
Data/Installed Packages/下是否有该文件，以及Data/Packages/User/是否生成了Package Control.sublime-settings
构建系统（.sublime-build）必须用绝对路径
Sublime 启动时不继承 shell 的 PATH，也不读 JAVA_HOME 或 PYTHONPATH。写 "cmd": ["python", "-u", "$file"] 在 Windows 上基本无效，macOS/Linux 上也常找不到 python3。
实操建议：
- 先在终端确认真实路径：
which python3（macOS/Linux）或where python（Windows），例如得到/opt/homebrew/bin/python3或C:UsersAliceAppDataLocalProgramsPythonPython311python.exe - 新建
Python3.sublime-build，内容类似：
{
"cmd": ["C:\Users\Alice\AppData\Local\Programs\Python\Python311\python.exe", "-u", "$file"],
"file_regex": "^[ ]*File "(...*?)", line ([0-9]*)",
"selector": "source.python"
}
注意 Windows 路径含空格时必须用双引号包裹整个路径；保存位置必须是 Data/Packages/User/（可通过 Preferences → Browse Packages… 进入）
- 虚拟环境要单独配：激活环境后运行
which python，把输出路径填进cmd字段；别指望“在终端里激活后再启动 Sublime”能生效
同步整个 Data 目录，但别忽略可执行文件版本
便携版的同步本质是文件同步，不是账号同步。只要 Data 目录完整，所有配置、插件、缓存都在里面。但容易被忽略的一点是：Data 依赖于同级的 sublime_text.exe（或 macOS/Linux 的可执行文件）版本。
实操建议：
- 推荐同步整个 Sublime 目录（含
sublime_text.exe+Data），而不是只同步Data；否则换机器后可能因版本差异导致插件兼容问题或设置丢失 - U 盘或移动硬盘若为 FAT32 格式，无法存放大于 4GB 的文件（某些插件包或缓存可能超限），建议格式化为 exFAT 或 NTFS（Windows）/ APFS（macOS）
-
Data/Packages/User/存所有用户级配置（如Preferences.sublime-settings）、快捷键、代码片段；Data/Installed Packages/存插件二进制包；部分插件（如SideBarEnhancements）还会在Data/Packages/下生成状态文件，这些都需一并同步
