Sublime Text .sublime-keymap文件调试及快捷键修改无效排查

问题场景 #

使用M1芯片、系统版本13.3.1的Mac，尝试修改Sublime Text快捷键：

• 将Command+Shift+上下箭头设为行上下交换
• 互换查找与替换的快捷键（Command+F打开替换面板，Command+Option+F打开查找面板）

已修改/Applications/Sublime Text.app/Contents/MacOS/Packages/User/Default.sublime-keymap文件，配置内容如下：

[
    {
        "keys": ["super+shift+up"],
        "command": "swapLines",
        "args":
        {
            "direction": "up"
        }
    },
    {
        "keys": ["super+shift+down"],
        "command": "swapLines",
        "args":
        {
            "direction": "down"
        }
    },
    {
        "keys": ["super+f"],
        "command": "showPanel",
        "args":
        {
            "panel": "replace"
        }
    },
    {
        "keys": ["super+alt+f"],
        "command": "showPanel",
        "args":
        {
            "panel": "find"
        }
    }
]

打开Sublime Text无报错，但所有快捷键修改均未生效。

解决步骤 #

1. 修正配置文件路径 #

你修改的是Sublime Text应用包内的配置文件，此路径属于默认系统包，修改内容不会被加载（且会被应用更新覆盖）。正确的用户配置路径应为：

~/Library/Application Support/Sublime Text/Packages/User/Default.sublime-keymap

快速打开正确配置的方式：

• 打开Sublime Text，点击顶部菜单 Preferences > Key Bindings
• 右侧编辑区即为用户自定义快捷键配置，将你的JSON代码粘贴到这里并保存。

2. 检查快捷键冲突 #

• 在Key Bindings界面，左侧是默认快捷键配置，用Command+F搜索你设置的快捷键（比如super+shift+up），确认默认配置中是否有相同快捷键绑定了其他命令。
• 用户配置优先级高于默认配置，但需确保你的配置语法正确，能正常覆盖默认设置。

3. 验证配置语法 #

打开Sublime Text控制台（View > Show Console），检查是否有JSON语法错误提示。如果配置文件存在逗号遗漏、括号不匹配等问题，会导致配置不生效。

4. 完全重启Sublime Text #

修改配置后，彻底退出Sublime Text（右键Dock图标选择退出，确保进程完全终止），再重新打开应用，测试快捷键是否生效。

内容的提问来源于stack exchange，提问作者Zane Phillips