不能直接用,但绝大部分Packages/User/下的配置文件可复用;需仅同步Preferences.sublime-settings、Package Control.sublime-settings、平台专属keymap、snippet及各插件用户配置,排除Session、Cache、.pyc等文件,并手动重装Package Control及依赖。

旧版Sublime Text(ST3)配置能直接用在ST4上吗?
不能直接用,但绝大部分 Packages/User/ 下的配置文件可以复用。ST4 不兼容 ST3 的插件二进制缓存、会话文件和部分 Python API(比如 sublime.Region 构造行为有微小差异),硬拷整个 Packages/ 或 Installed Packages/ 会导致插件加载失败、命令面板空白、甚至启动卡死。
同步时哪些文件必须保留,哪些必须丢弃?
只同步以下内容,其余一律不碰:
-
Preferences.sublime-settings(主题、字体、缩进、自动保存等) -
Package Control.sublime-settings(含installed_packages列表,这是重装插件的依据) - 平台专属快捷键文件:
Default (Windows).sublime-keymap、Default (OSX).sublime-keymap或Default (Linux).sublime-keymap - 所有
*.sublime-snippet文件 - 各插件的用户配置,如
SideBarEnhancements.sublime-settings、Emmet.sublime-settings
必须排除的包括:Session.sublime_session、Local/ 全目录、Cache/、Index/、Package Control.cache/,以及任何以 .pyc 或 .cache 结尾的文件。
ST3 配置迁移到 ST4 后插件不加载怎么办?
常见原因不是配置错了,而是 Package Control 没认出新环境。ST4 默认不自带 Package Control,必须手动安装;且已安装插件不会自动迁移——它只读取 Package Control.sublime-settings 里的 installed_packages 列表,然后重新下载。
操作步骤:
- 先退出 ST4
- 确认
Packages/User/Package Control.sublime-settings已存在且含有效installed_packages数组 - 启动 ST4,按
Cmd+Shift+P(macOS)或Ctrl+Shift+P(Windows/Linux)打开命令面板 - 输入
Package Control: Install Package,等待几秒——如果命令没出现,说明 Package Control 没装好,需重装 - 装好后,再运行
Package Control: Satisfy Dependencies,修复因 API 变更导致的依赖缺失(比如某些插件依赖的旧版mdpopups)
跨版本同步最易忽略的兼容点
很多人以为同步完就万事大吉,结果在 ST4 上发现中文乱码、侧边栏图标白板、或者 Emmet 展开失效。这些问题往往源于两个被忽略的细节:
- ST4 默认禁用
convert_to_utf8类插件对非 UTF-8 文件的自动解码,若你之前靠ConvertToUTF8插件处理 GBK 文件,现在得改用官方支持的encoding设置 + 手动重载编码,或换用 ST4 兼容的GBK Encoding Support - 所有插件的用户配置中,若含
"platforms": ["windows"]这类条件块,ST4 解析更严格,建议统一改用"platforms": ["osx", "windows", "linux"]或删掉该字段,让配置全局生效
真正麻烦的从来不是“怎么同步”,而是同步之后那一两处不起眼的平台判断或编码 fallback —— 它们不会报错,只会让你觉得“好像哪里不对”。


















