emacs 快捷键设置 基础知识篇
原文地址:http://xahlee.org/emacs/keyboard_shortcuts.html
中文简单参考:http://hi.baidu.com/lhaix/blog/item/e803d9d02736b098a0ec9c16.html
官方命令参考地址:http://www.gnu.org/software/libtool/manual/emacs/Change-Window.html#Change-Window
Emacs: How to Define Keyboard Shortcuts
Xah Lee, 2005, …, 2009, 2011-02
In emacs, you can create any keyboard shortcut to any command. This page shows you how.
The act of creating a keyboard shortcut is called keybinding. For example, if you want 【Ctrl+z】 to be undo, then, place this code (global-set-key (kbd "C-z") 'undo)
in your emacs init file and restart emacs. If you are experimenting, and don't want to restart emacs everytime you try to define a new shortcut, you can select the lisp code then type 【Alt+x eval-region】.
If you made some bad mistake and need to start emacs without loading your init files, you can start emacs on the command line like this: emacs -Q
.
Examples
Here are sample code you need to place in your emacs init file for defining various key press combinations.
The Meta key is a key on some keyboards in the 1980s. (for photos, see:Keyboard Hardware's Influence on Keyboard Shortcut Design (How Emacs and vi keys came to be)) The Meta key doesn't exist in today's keyboards, but emacs remap it to PC keyboard's Alt key by default. When you see Meta mentioned in emacs, just think of it as Alt.
In the following, the “backward-char” is a example command. Replace it with the command name you want.
Single Modifier Key
Example of shortcuts with a single modifier key:
(global-set-key (kbd "M-a") 'backward-char) ; Meta+a (global-set-key (kbd "C-a") 'backward-char) ; Ctrl+a
Function keys and Special keys
Example of shortcuts with a special key:
(global-set-key (kbd "<f2>") 'backward-char) ; F2 key (global-set-key (kbd "<kp-2>") 'backward-char) ; the “2” key on the number keypad (global-set-key (kbd "<insert>") 'backward-char) ; the Ins key (global-set-key (kbd "<delete>") 'backward-char) ; the Del key (global-set-key (kbd "<home>") 'backward-char) (global-set-key (kbd "<end>") 'backward-char) (global-set-key (kbd "<next>") 'backward-char) ; page down key (global-set-key (kbd "<prior>") 'backward-char) ; page up key (global-set-key (kbd "<left>") 'backward-char) ; ← (global-set-key (kbd "<right>") 'backward-char) ; → (global-set-key (kbd "<up>") 'backward-char) ; ↑ (global-set-key (kbd "<down>") 'backward-char) ; ↓ (global-set-key (kbd "RET") 'backward-char) ; the Enter/Return key (global-set-key (kbd "SPC") 'backward-char) ; the Space bar key
(info "(elisp) Function Keys")
Modifier + Special Key
Example of shortcuts with a modifier key and a special key:
(global-set-key (kbd "M-<f2>") 'backward-char) ; Meta+F2 (global-set-key (kbd "C-<f2>") 'backward-char) ; Ctrl+F2 (global-set-key (kbd "S-<f2>") 'backward-char) ; Shift+F2 (global-set-key (kbd "M-<up>") 'backward-char) ; Meta+↑ (global-set-key (kbd "C-<up>") 'backward-char) ; Ctrl+↑ (global-set-key (kbd "S-<up>") 'backward-char) ; Shift+↑
Two Modifier Keys
Example of shortcuts with 2 modifier keys pressed simultaneously, plus a letter key:
(global-set-key (kbd "M-A") 'backward-char) ; Meta+Shift+a (global-set-key (kbd "C-A") 'backward-char) ; Ctrl+Shift+a (global-set-key (kbd "C-M-a") 'backward-char) ; Ctrl+Meta+a
Example of 2 modifier keys with a digit key:
(global-set-key (kbd "M-@") 'backward-char) ; Meta+Shift+2 or Meta+@ (global-set-key (kbd "C-@") 'backward-char) ; Ctrl+Shift+2 or Ctrl+@ (global-set-key (kbd "C-M-2") 'backward-char) ; Ctrl+Meta+2 (global-set-key (kbd "C-S-<kp-2>") 'backward-char); Ctrl+Shift+“numberic pad 2”
Three Modifier Keys
Example of 3 modifier keys:
(global-set-key (kbd "C-M-S-a") 'backward-char) ; Ctrl+Meta+Shift+a (global-set-key (kbd "C-M-!") 'backward-char) ; Ctrl+Meta+Shift+1 or Ctrl+Meta+! (global-set-key (kbd "C-M-\"") 'backward-char) ; Ctrl+Meta+Shift+' or Ctrl+Meta+" (global-set-key (kbd "C-M-S-<up>") 'backward-char); Ctrl+Meta+Shift+↑
Key Sequence
Example of shortcuts with a sequence of keystrokes:
(global-set-key (kbd "C-c a") 'backward-char) ; Ctrl+c a (global-set-key (kbd "C-c SPC") 'backward-char) ; Ctrl+c Space (global-set-key (kbd "C-c <f2>") 'backward-char) ; Ctrl+c f2 (global-set-key (kbd "C-c <up>") 'backward-char) ; Ctrl+c ↑ (global-set-key (kbd "C-c C-c <up>") 'backward-char); Ctrl+c Ctrl+c ↑
No Modifiers
A shortcut can be created without any modifier keys.
(global-set-key (kbd "2") 'backward-char) (global-set-key (kbd "a") 'backward-char) (global-set-key (kbd "é") 'backward-char) (global-set-key (kbd "α") 'backward-char) (global-set-key (kbd "π") 'backward-char) (global-set-key (kbd "(") 'backward-char) (global-set-key (kbd "你") 'backward-char)
Keys To Avoid
Emacs has its quirks. The following keys you should not redefine:
- Keys involving the question mark symbol “?”. (due to emacs technical implementation quirk)
- The Esc key or 【Ctrl+[】. (The Esc key is tied to 【Ctrl+[】 and Meta. Esc by itself has complicated meanings depending when it is pressed and how many times it is pressed.)
- 【Ctrl+h】 (This key combo is used for emacs help system and have a special status in emacs's key system. You should not have 【Ctrl+h】 in your own shortcut, because by default that brings up help about the key sequence you've just typed.)
- 【Ctrl+m】 or Enter (These are tied together. On Apple Keyboards the main Enter is labeled Return.)
- 【Ctrl+i】 or Tab (These are tied together)
- 【Ctrl+Shift+‹letter›】. In text terminals, it cannot distinguish shifted and unshifted versions of such combination. Works fine if you always use emacs in a GUI environment.
Good Key Choices
Emacs has some 7 thousand commands. By default, 800 of them has key shortcuts. All the common key spots are used. If you define your own keys without care, you may find that many major mode or minor mode override your keys, because they have priority.
By official emacs documentation (info "Key Binding Conventions") , the key space for users are the function keys F5 to F9, and 【Ctrl+c ‹letter›】. This is very restrictive.
The following keys are good spots for your own definitions, and does not cause any problems in practice.
Keys | Comment |
---|---|
F5, F6, F7, F8, F9, F11,F12 | Excellent |
F1, F2, F3, F4, F10 | Good if you don't use their defaults actions. |
【Ctrl+F1】 to 【Ctrl+F12】 | Excellent |
【Alt+F1】 to 【Alt+F12】 | Excellent |
【Shift+F1】 to 【Shift+F12】 | Excellent |
【Ctrl+0】 to 【Ctrl+9】, 【Alt+0】 to 【Alt+9】 | Good. By default, they call “digit-argument”, which is not often used. |
Keys on number pad, with or without a modifier | Very useful, but depending on which emacs distribution you are using, and on what operating system you are running, or terminal vs GUI, binding these keys may not work. Same thing can be said for those Insert, Delete, Home, End, Page Up, Page Down keys. |
Syntax Problem with Shift Key Combination
A keypress combination such as 【Meta+Shift+2】 can also be considered as 【Meta+@】. So, in emacs, you might be thinking that both of these code: (kbd "M-S-2")
and (kbd "M-@")
will work. Actually, only the latter will work.
When writing a keybinding definition, for a key combination that is 【Meta+Shift+‹key›】, you must use a code without the -S
if possible. But for key combination that is 【Ctrl+Shift+‹key›】, you must use the -S
. Examples:
GOOD | BAD | Keystroke |
---|---|---|
(kbd "M-A") |
(kbd "M-S-a") |
Meta+Shift+a |
(kbd "M-@") |
(kbd "M-S-2") |
Meta+Shift+2 |
(kbd "M-:") |
(kbd "M-S-;") |
Meta+Shift+; |
(kbd "C-S-a") |
(kbd "C-A") |
Ctrl+Shift+a |
A easy way to find out the proper syntax, is to call “describe-key” 【Ctrl+h k】, then type the keystroke.
Note also, that keys involving 【Ctrl+Shift+‹key›】 cannot be distinguished from 【Ctrl+‹key›】 when emacs runs in a text terminal (telnet/ssh).
Example of shortcut with a punctuation key that are typed with Shift:
(global-set-key (kbd "C-:") 'backward-char) ; Ctrl+Shift+; or Ctrl+: (global-set-key (kbd "C-\"") 'backward-char) ; Ctrl+Shift+' or Ctrl+" ; note: the question mark “?” cannot be used in shortcut.
Example of 2 modifier keys with a special key:
(global-set-key (kbd "M-S-<f1>") 'backward-char) ; Meta+Shift+F1 (global-set-key (kbd "C-S-<kp-2>") 'backward-char) ; Ctrl+Shift+“numberic pad 2” (global-set-key (kbd "C-M-<up>") 'backward-char) ; Ctrl+Meta+↑
Order of Modifier Keys in Syntax
When there are more than one modifier keys, such as (kbd "C-M-a")
【Ctrl+Alt+a】, the order of the modifier in the string does not matter. It is recommended that they be alphabetical. So, type “C-M-a”, not “M-C-a”.
Super & Hyper Keys
Emacs supports extra modifier keys called Super & Hyper. On a PC keyboard, you can set the Win key or Menu key to them, or Apple keyboard's ⌥ Opt or⌘ Cmd key. See: Emacs: How to define Super & Hyper Keys.
Common Questions
How to unset a keybinding?
To unset a keybinding, use “global-unset-key”. For example, you have defined a keystroke for undo, and wants to kick the habit of the hitting the default shortcut for undo:
(global-unset-key (kbd "C-_"))
How to find out the current keybinding to a key?
Type 【Ctrl+h k】 (describe-key), then type the key combination. Emacs will then show the function that key press is bound to.
To see a list of ALL current keybindings, type 【Ctrl+h b】 (describe-bindings).
How to find out the syntax for a particular key combination?
Call “describe-key” 【Ctrl+h k】, then press the key combination. Emacs will then display its syntax. For example, suppose you want to know the syntax for the key press of 【Ctrl+Alt+F8】. Call “describe-key”, then press 【Ctrl+Alt+F8】, then emacs will print “<C-M-f8> is undefined”. That means, you can use (kbd "<C-M-f8>")
to represent that key combination in lisp code.
Note: There is a lot syntax variations, but the one printed by “describe-key” is guaranteed to work. For details of emacs's keystroke syntax variation, see:Emacs's Key Notations Explained (/r, ^M, C-m, RET, <return>, M-, meta).
How to have a keyboard shortcut set only when a particular mode is active?
Use a hook for the mode. A hook will load your code whenever that mode is activated. Here's a usable example:
; define some keys only when the major mode html-mode is active (add-hook 'html-mode-hook (lambda () (local-set-key (kbd "C-c w") 'bold-word) (local-set-key (kbd "C-c b") 'blue-word) (local-set-key (kbd "C-c p") 'insert-p) (local-set-key (kbd "M-4") 'tag-image) (local-set-key (kbd "M-5") 'wrap-url) ) )
How to change major mode or minor mode's keys?
How to swap Caps Lock and Control key?
You cannot do it within emacs, because these are at the OS level. See:
Practical Examples
See: Emacs Custom Keybinding to Enhance Productivity.
References and Further Readings
- (info "(emacs) Key Bindings")
- (info "(elisp) Keymaps")
- Emacs's Key Notations Explained (/r, ^M, C-m, RET, <return>, M-, meta)
完