直接备份Packages/User目录即可完整还原快捷键,前提是Sublime Text进程已彻底退出,且所有自定义键位规则均正确写入对应系统的User.sublime-keymap文件(如Default (Windows).sublime-keymap),command字段名准确无误,并同步包含Package Control.sublime-settings等依赖配置。

直接备份 Packages/User 目录就能完整还原快捷键,但前提是 Sublime Text 进程已彻底退出,且你添加的键位规则确实写进了正确的 .sublime-keymap 文件里——否则复制了也白复制。
为什么只复制 User 目录就足够
Sublime Text 的快捷键生效逻辑很明确:所有用户级绑定必须落在 Packages/User/ 下的 JSON 文件中,比如 Default (Windows).sublime-keymap 或 Preferences.sublime-keymap。插件自带的默认快捷键(如 Packages/SideBarEnhancements/Default (Windows).sublime-keymap)是只读的,改了也不生效;只有你手动加进 User/ 里的才真正属于你、可迁移、可备份。
-
command字段必须和插件实际暴露的命令名完全一致,大小写、下划线都不能错,比如side_bar_open_in_terminal不是open_in_terminal - Windows/macOS/Linux 的文件名不同:
Default (Windows).sublime-keymap、Default (OSX).sublime-keymap、Default (Linux).sublime-keymap,必须按当前系统备份对应文件 - 如果你为 Python 或 JavaScript 单独写了
Python.sublime-keymap,也要一并打包进去
备份前必须关掉 Sublime Text 进程
只要 sublime_text.exe(Windows)、Sublime Text(macOS)或 sublime_text(Linux)还在后台跑着,User/ 下的 JSON 文件就可能被热重载机制覆盖、写入临时内容,甚至因文件锁导致复制不全。常见现象是:还原后快捷键报 command not found,或者 JSON 解析失败(末尾多逗号、空行、中文标点)。
- Windows:任务管理器 → 详细信息 → 搜索
sublime_text.exe和subl.exe→ 全部结束 - macOS:活动监视器中找
Sublime Text,或终端执行ps aux | grep sublime,有输出就用kill -9 [PID] - Linux:运行
pkill -f "sublime_text"或killall sublime_text
还原时别只粘贴 keymap 文件
单独还原 Preferences.sublime-keymap 能让快捷键“看起来”回来了,但大概率会出行为异常——比如 ctrl+shift+p 打不开命令面板,或右键菜单空白。这是因为快捷键依赖其他配置协同工作:
-
Package Control.sublime-settings决定哪些插件启用,而很多插件自带快捷键(如SideBarEnhancements) -
Preferences.sublime-settings控制tab_size、translate_tabs_to_spaces等基础行为,某些命令(如缩进相关)依赖这些设置 - 插件专属 keymap 文件(如
Emmet.sublime-keymap)若存在,也必须一起还原,否则自定义绑定失效
所以真正可靠的还原动作,是把整个 Packages/User 目录原样覆盖过去,而不是挑文件。
容易被忽略的兼容性细节
路径大小写、版本号、短横线/下划线,看着像小事,但错一个字符就会还原失败。便携版和常规版路径结构也不同:
- 便携版:真实路径是
Data\Packages(注意Data首字母大写),所有配置都在同级Data文件夹里 - 常规版 Windows:路径是
%APPDATA%\Sublime Text 4\Packages(带空格、带版本号,不是SublimeText4) - 常规版 macOS:路径是
~/Library/Application Support/Sublime Text/Packages(Sublime Text 4 安装后仍叫Sublime Text,不带版本号) - 常规版 Linux:路径是
~/.config/sublime-text-4/Packages(短横线-,全小写,不是下划线_)
最保险的方式是启动 Sublime Text 后,点 Preferences → Browse Packages…,看弹出窗口地址——那就是你要操作的真实路径起点。


















