探索 Doom Emacs 的快捷键命令

global-set-key 设置的是全局快捷键，它不会被绑定到任何 Major mode 或 minor mode 中，优先级是最低的。可以将其理解为一个基础的键位设定，当启用的 Major mode 或 minor mode 中对该快捷键设置了其他的功能时，使用 global-set-key 设置的功能就不会表现出来。

(global-set-key (kbd "key") 'command)
;; for a real example
(global-set-key (kbd "s-k")
    (lambda () (interactive) (evil-previous-line 5)))

上面的例子中，我们将 s-k 键（s 在 macOS 中为 Command 键）设置为光标往上移动五行。

设置成功以后，可以使用 SPC hk 查看 s-k 快捷键，发现它的 Key Bindings 描述为 global-map s-k , 说明该快捷键绑定在 global map 中。使用 SPC h b k 打开 which-key-show-map 搜索 global map 就可以找到刚才定义的快捷键了,或者使用 SPC h v 查找 global map 这个变量,也可以找到该快捷键.

(local-set-key (kbd "key") 'command)

使用 SPC hf 查看 local-set-key 的说明，发现：

The binding goes in the current buffer's local map, which in most cases is shared with all other buffers in the same major mode.

发现这个绑定被放到了 the current buffer's local map 中，这个 map 会被该 buffer 相同的 major mode 所使用。所以说 local-set-key 也可以被记忆为基于 Major-Mode 的局部快捷键设置命令。

在下面的例子中，我们将快捷键绑定到 Org Mode 中，当 major mode 为 Org Mode 时，按下 s-k 快捷键时，光标将会跳转到上一个 heading 上。

;; for a real example
(add-hook 'org-mode-hook
          '(lambda ()
             (local-set-key (kbd "s-k") 'org-previous-visible-heading)))

这里结合 add-hook ，使用 local-set-key 设置了仅在 org-mode（必须为一个 major mode） 中生效的 local 快捷键，不会影响到其他 major-mode 中。设置成功后，使用 SPC h b m 可以在当前的 Major mode key map 中找到 s-k 快捷键，当然这需要当前的 major mode 为 org-mode。

使用 define-key 定义的局部快捷键绑定在特定的 KEYMAP 中，仅在 major or minor-mode 启用该 KEYMAP 时生效。这使我们可以精确地对快捷键进行控制。相比起前两种定义，这种方式范围最精确，优先级也最高。

;; example in SPC hf -> define-key
(define-key evil-motion-state-map (kbd "s-k") 'emacs-version)

这个例子我们使用了 define-key 对 s-k 快捷键绑定在 evil-motion-state-map 中，当 这个 KEYMAP 被启用时，按下 s-k 将会在底部打印 Emacs 的版本信息。

但是实际我们用的最多的是 general package 提供的 general-define-key 命令来创建绑定在 KEYMAP 的局部快捷键，它可以提供更为强大的功能。接下来我们使用 general-define-key 来实现与上面的 define-key 相同的功能。

(general-define-key :keymaps
                    '(evil-motion-state-map)
                    "s-k"
                    (list :def 'emacs-version :which-key "show emacs-version"))

Doom Emacs 中还提供了一个 map! 命令，使用 SPC hf map! 可以看到：

A convenience macro for defining keybinds, powered by general.

当光标位于 map! 之上时，可以使用 M-x macrostep expend 对其进行展开，下面的 map! 代码块展开即为上文中的 general-define-key 代码块。

(map! :map evil-motion-state-map
      :desc "show emacs-version" "s-k"  'emacs-version
  )

这里先对 general 以及 map! 的基本概念有个大致了解，后续将对它们的用法和写法做详细介绍。