sublime text升级后设置未继承是因st4与st3配置目录不兼容且不支持覆盖安装，需手动迁移packages/user目录（含字体、快捷键、插件配置等）或便携版的data文件夹，同时彻底卸载旧版、确认build号并从官网下载对应安装包。
Sublime Text 升级后设置没继承过来，不是安装出错，而是 ST4 和 ST3 的配置目录不兼容，且官方不支持覆盖安装。所谓“无缝衔接”，本质是手动迁移关键路径，不是靠安装程序自动完成。
升级前必须彻底卸载旧版并确认 Build 号
ST3 和 ST4 使用不同注册表项（Windows）、plist 文件（macOS）和配置目录（Linux），强行覆盖会导致 Preferences.sublime-settings 重置、插件菜单空白或启动失败。
- Windows：从控制面板卸载 Sublime Text，别只删快捷方式；任务管理器里确认
sublime_text.exe进程已退出 - macOS：把
/Applications/Sublime Text.app拖到废纸篓，再用ps aux | grep sublime确认无残留进程 - Linux：删除
/opt/sublime_text，清理软链接/usr/local/bin/subl - Help → About Sublime Text 查真实 Build 号（如
Build 3211），别信安装包名或图标显示的“Sublime Text 4”字样
只迁移 Packages/User 目录就足够了
这个目录包含所有你真正关心的个性化配置：字体、缩进、主题、快捷键、代码片段、插件开关状态、各插件的用户级配置（如 SideBarEnhancements.sublime-settings）。它不含插件源码或平台相关缓存，跨版本（ST3→ST4）、跨平台都兼容。
- 误迁整个
Packages目录会引发ImportError: No module named 'package_control'或命令面板卡死 - 务必通过 Preferences → Browse Packages… 打开真实路径——不同系统、便携版/非便携版路径完全不同，硬记
%APPDATA%或~/Library/Application Support极易出错 - 同步时必须关掉 Sublime Text，否则
Preferences.sublime-settings~临时文件可能残留，导致配置被部分覆盖
便携版升级时只换二进制，不动 Data 文件夹
便携版所有用户数据都在 Data（大写 D、小写 ata）文件夹，平级放在 sublime_text.exe（Windows）或 Sublime Text（macOS/Linux）旁边。升级时只需替换可执行文件，Data 必须原样保留。
- 常见错误：解压新版 zip 包直接覆盖整个旧目录——这会清空
Data，全部配置丢失 - 升级前完整备份整个
Data文件夹，不是只拷Data\Packages\User - 验证是否成功：启动后 Help → About Sublime Text 查 Build 号，再 Preferences → Browse Packages… 看路径是否仍指向
Data\Packages
升级后第一个要检查的是 UnicodeDecodeError: 'utf-8' codec can't decode byte
ST4 默认强制 UTF-8 解码，而 ST3 对非 UTF-8 编码文件更宽容。如果你有 GBK、ISO-8859-1 编码的旧项目文件，打开时会直接报错或乱码。
- 临时解决：右下角编码选择器点开 → Reopen with Encoding → 选对应编码（如
GB2312） - 长期方案：批量转码（可用
iconv或 VSCode 的 Save with Encoding），并在Preferences.sublime-settings中加"fallback_encoding": "GBK" - 别忽略这个错误——它不影响启动，但会让部分文件无法编辑，且容易被当成“插件失效”误判
