便携版启动失败需确保data文件夹与sublime_text.exe同级且严格命名；同步仅限data\packages\user，禁同步installed packages和cache；云盘同步须退出程序并用符号链接；首次运行需手动安装package control。
便携版启动失败？检查Data文件夹位置和命名
Sublime Text 便携模式不靠安装选项，只认同级目录下严格命名为 Data 的空文件夹。解压官网.zip后，sublime_text.exe 和 Data 必须在同一层目录；建在子目录里、拼成 data 或 DATA 都无效。
验证方式：菜单 → Preferences → Browse Packages…，路径必须显示为 Data\Packages，否则说明没生效。
同步全局配置时只动User目录，别碰Data其他子目录
便携版的 Data\Packages\User 是唯一该同步的部分——它存着所有你改过的 Preferences.sublime-settings、Package Control.sublime-settings、*.sublime-keymap 和 *.sublime-snippet。但 Data\Installed Packages 和 Data\Cache 绝对不要同步：
• Installed Packages 里是插件二进制包，不同设备 Python 环境或架构（x64/arm64）不一致时会触发 ImportError: No module named 'package_control'
• Cache 和 Local 含 Session、缓存等本地状态，跨设备覆盖后会导致插件菜单变灰、快捷键失效
云盘同步前必须关掉Sublime，且用符号链接挂载
直接复制整个 Data 文件夹到云盘再覆盖另一台电脑，大概率出错。正确做法是：
• 先退出 Sublime（包括后台进程，任务管理器里确认无 sublime_text.exe）
• 把 Data\Packages\User 整个剪切到云盘路径（如 Dropbox\SublimeConfig\User）
• 删除原 Data\Packages\User 目录
• 在原位置创建符号链接：
Windows（管理员 CMD）：mklink /J "D:\SublimeText_Portable\Data\Packages\User" "D:\Dropbox\SublimeConfig\User"
macOS/Linux（终端）：ln -s ~/Dropbox/SublimeConfig/User ~/SublimeText_Portable/Data/Packages/User
Dropbox、坚果云比 iCloud/OneDrive 更稳，后者对 ~/.config 或 %APPDATA% 同步支持差，容易漏文件或卡住
首次在新设备运行，Package Control要手动装
便携版不会自动带 Package Control，Ctrl+` 打开控制台后，粘贴执行这段代码（注意是 Python 3 兼容版本）：import urllib.request,os,hashlib; h ='df21e130d211cfc94d9b0905775a7c0f1e3d39e33b79698005270310898eea76'; pf ='Package Control.sublime-package'; ipp = sublime.installed_packages_path(); urllib.request.install_opener(urllib.request.build_opener(urllib.request.ProxyHandler())); by = urllib.request.urlopen('http://packagecontrol.io/'+ pf.replace(' ','%20')).read(); dh = hashlib.sha256(by).hexdigest(); print('Error validating download (got %s instead of %s), please try manual install'% (dh, h)) if dh != h else open(os.path.join(ipp, pf),'wb').write(by)
成功后重启，再按 Ctrl+Shift+P 就能搜到 Package Control: Install Package。已装插件列表存在 Package Control.sublime-settings 里，只要这个文件同步了，重启时会自动拉取
.sublime-keymap 若含 CRLF，在 macOS 上可能解析失败导致快捷键全灭；Vue 文件里 snippet 的 scope 写成 source.js 而非 source.vue，同步过去也照样不触发——这些得靠 Ctrl+Shift+P → Developer: Show Scope Name 实时核对，不是同步本身能解决的。
