sublime text 升级后配置“损坏”实为不兼容导致的静默失效，因无校验机制，旧版 api、插件名、语法定义等非法项被跳过或引发崩溃，表现为功能缺失而非报错；应优先删 preferences.sublime-settings 并用 --safe-mode 排查插件问题。
Sublime Text 升级后配置损坏，不是“修复”而是“重建”——它没有配置校验或自动降级机制，升级过程会保留旧配置目录但不保证兼容性，尤其跨大版本（如 3 → 4）时 Preferences.sublime-settings 或 Default (Windows).sublime-keymap 里引用的旧 API、已移除插件、废弃语法定义都会直接导致启动卡顿、快捷键失效、甚至界面空白。
为什么升级后配置会“损坏”而不是“报错”
Sublime 不做运行时配置兼容性检查：它读到非法 key、不存在的插件名、或已被删除的语法高亮定义时，只会静默跳过或崩溃在加载阶段。你看到的现象往往是“功能缺失”而非错误弹窗——比如 Ctrl+Shift+P 打不开命令面板、侧边栏消失、保存没反应，其实都是某一行配置在新版里已失效。
-
hot_exit在 ST4 中行为变更，旧版设为true可能导致会话恢复失败 - ST4 移除了
theme_hidden等 UI 相关设置项，若仍写在Preferences.sublime-settings中，主题可能无法加载 - 某些插件（如 Vintage、Emmet）在 ST4 中需手动更新，旧版 keymap 文件残留会覆盖新绑定
- 路径大小写敏感问题：Linux/macOS 下
~/.config/sublime-text-4错写成sublimetext4，会导致配置根本没被读取
删 Preferences.sublime-settings 比删整个 Data 目录更安全
升级后配置异常，优先只删用户主配置文件，而非整个 Data 目录——前者只清掉字体、缩进、主题等基础项；后者会连插件、自定义快捷键、未同步的包都一并丢掉，且重装插件后还得重新配置。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 关闭 Sublime Text，确认进程已退出（Windows 查
sublime_text.exe，macOS 查Sublime Text，Linux 运行pkill -f "sublime_text"） - 定位到
Packages/User/子目录：
Windows：%APPDATA%\Sublime Text 4\Packages\User\
macOS：~/Library/Application Support/Sublime Text/Packages/User/
Linux：~/.config/sublime-text-4/Packages/User/ - 删掉或重命名
Preferences.sublime-settings（不要动Package Control.sublime-settings，否则插件管理器会重装所有包） - 重启 Sublime，它会生成一份干净的默认配置；再逐条把旧配置里确认兼容的项复制回来（比如
"font_size": 13）
用 subl --safe-mode 快速定位是配置还是插件问题
如果删了 Preferences.sublime-settings 后仍异常，说明问题出在插件或其配置上——--safe-mode 跳过 Packages/User/ 和所有插件，只加载内置逻辑，是唯一能快速隔离问题的手段。
- 终端执行
subl --safe-mode（Windows 可用命令提示符，macOS/Linux 用 Terminal） - 在安全模式下测试：Ctrl+Shift+P 是否可用？快捷键是否响应？主题是否正常？
- 如果安全模式下一切正常，问题一定来自插件或
Packages/User/下其他文件（如Default (Windows).sublime-keymap） - 此时可逐个禁用插件：菜单 → Preferences → Package Control → Disable Package，从最近安装或更新的开始
别忽略 Sync Settings 的云端污染
如果你用 subl --sync-login 登录过账号，升级后首次启动会自动从云端拉取旧版配置——哪怕你本地删光了，也会瞬间还原损坏状态。
- 升级前若已登录，必须先执行
subl --sync-logout（终端运行），或菜单 Preferences → Sync Settings → Logout - 登出后再删配置、重启，确保首次启动是纯本地初始化
- 登出后若需恢复部分配置，应从备份中手动复制，而非重新登录同步
真正麻烦的不是删文件，而是判断哪一行配置在新版里已失效——ST4 对 JSON 格式更严格，多一个逗号、少一个引号就会让整份 Preferences.sublime-settings 加载失败，而它不会告诉你错在哪行。建议每次升级后，先把旧配置重命名为 Preferences.sublime-settings.backup，再新建一份空配置测试，逐步粘贴旧项验证兼容性。
