Emacs

快捷键速查

操作	快捷键
打开文件	`C-x C-f`
保存	`C-x C-s`
另存为	`C-x C-w`
搜索	`C-s` / `C-r`
替换	`M-%`
撤销	`C-/`
复制行	`C-a M-w`
剪切行	`C-a C-k`
粘贴	`C-y`
分屏	`C-x 2`（水平）/ `C-x 3`（垂直）
切换窗口	`C-x o`
关闭窗口	`C-x 0`
查看字符信息	`C-u C-x =`
选中段落	`v i p` 或 `v a p`
录制脚本并执行	`C-x (` 或 kmacro-start-macro

配置

自定义 init 目录

# Emacs 27+ 原生支持
emacs --init-directory ~/myconfig/emacs.d

# 调试模式
emacs --init-directory ~/myconfig/emacs.d --debug-init

# 不加载任何配置
emacs -q

常用启动参数

参数	作用
`--init-directory DIR`	指定配置目录（Emacs 27+）
`-q`	不加载 init.el
`--debug-init`	init 报错时显示 backtrace
`-nw`	终端模式
`-l FILE`	启动后加载指定文件
`--daemon`	启动守护进程

常见问题

Helm 找不到新文件

目录缓存未刷新，按 C-c C-u 强制刷新。

Markdown 友好显示

M-x markdown-toggle-markup-hiding
M-x markdown-toggle-url-hiding

编辑网页 textarea

安装 edit-server 包，配置：

(use-package edit-server
  :ensure t
  :commands edit-server-start
  :init (if after-init-time
            (edit-server-start)
          (add-hook 'after-init-hook
                    #'(lambda() (edit-server-start)))))

查看光标字符信息

需求	操作
快速看编码、行列位置	`C-x =`
查完整 Unicode、字节编码	`C-u C-x =`
自动显示字符名称	`(setq what-cursor-show-names t)`

扩展

Org mode

大纲：* 标题，TAB 折叠
TODO：C-c C-t 切换状态
时间戳：C-c C-s 开始，C-c C-d 截止
导出：C-c C-e

Org Agenda（Spacemacs）

配置

在 dotspacemacs/user-config 中：

(setq org-agenda-files '("~/org/" "~/org/todo.org"))

(setq org-agenda-custom-commands
      '(("w" "Weekly Review"
         agenda ""
         ((org-agenda-span 'week)))))

快捷键

按键	作用
`SPC a o o`	打开 Org Agenda 主视图
`SPC a o a`	当天 Agenda

Agenda 视图内：

按键	作用
`d`	日视图
`w`	周视图
`t`	只显示 TODO
`T`	按标签过滤
`f` / `b`	前/后一天
`g r`	刷新
`q`	退出
`RET`	跳转到源条目
`B`	按日期排序

Org 文件中标记时间

手动写：标题下一行直接写 SCHEDULED: 或 DEADLINE:，中间不能有空行：

* TODO 学习 Python
  SCHEDULED: <2026-07-25 周六 05:00>

* TODO AI项目
  DEADLINE: <2026-07-26 周日>

快捷键：

按键	作用
`C-c C-s`	设置 SCHEDULED 时间
`C-c C-d`	设置 DEADLINE 时间

输入后弹出日历选日期，再输入具体时间。

重复代办（Repeater）

时间戳末尾加 +间隔 就是重复器：

* TODO 健身
  SCHEDULED: <2026-08-03 周一 07:00 +1w>

+1w 每周、+1m 每月、+2d 每两天
输入：C-c C-s 设置后，在时间戳的 > 前手动加 +1w

推进规则（前缀不同）：

写法	含义
`+1w`	按时完成：下次 = 原定日期 + 1 周
`++1w`	顺延：下次 = 实际完成日 + 1 周
`.+1w`	从完成当天起算

完成后打勾：Agenda 视图光标移到该行，t 切换 TODO/DONE，x 直接标记 DONE 并归档。标记 DONE 时重复器自动把时间戳推进到下次，条目从当天消失。只会在 TODO→DONE 方向推进。

时间统计（Clock）

Agenda 视图内：

按键	作用
`tr`	Clock Report — 显示时钟汇总表
`tl`	Log Mode — 显示已完成条目和时钟历史

在 org 文件中操作时钟：

按键	作用
`SPC m C i`	开始计时（clock-in）
`SPC m C o`	停止计时（clock-out）
`SPC m C d`	临时显示当前文件的时钟时间
`SPC m C R`	插入时钟报告表格

在 org 文件中手动记录：

* TODO 学习 Python
  CLOCK: [2026-07-24 周四 05:00] → [2026-07-24 周四 06:00] => 1:00

插入 clocktable 汇总：

#+BEGIN: clocktable :scope file :block today
#+END:

Clock 空闲时间调整

当 clock in 期间有空闲时间（离开电脑），Emacs 会询问如何处理。

选项	作用
`i` / `q`	保留全部空闲时间
`k`	保留指定分钟数（推荐）
`t`	指定分心开始时间
`g`	指定返回工作时间
`s`	删除全部空闲时间
`c`	取消整个 clock
`j`	跳到当前 clock 手动修正

大写区别：大写字母操作后自动 clock out（结束任务）。

推荐配置：k + 10 分钟，配合每天 clock report 查看统计。

Magit（Git）

操作	快捷键
状态	`C-x g`
暂存文件	`s`
提交	`c c`
推送	`P u`
日志	`l l`
创建分支	`b c`

ERC（IRC）

最大网络 Libera.Chat（~30,000人），启用：

(erc :variables
     erc-server-list '(("irc.libera.chat"
                        :port "6697" :ssl t
                        :nick "昵称")))

密码放 ~/.authinfo.gpg，启用后 SPC a c i e 启动。

browse-url 使用 eww

全局使用 Emacs 内置浏览器：

(setq browse-url-browser-function 'eww-browse-url)

仅 elfeed 文章用 eww（其他场景仍用外部浏览器）：

(add-hook 'elfeed-show-mode-map
          (kbd "b") (lambda () (interactive)
                      (eww-browse-url (elfeed-entry-link elfeed-show-entry))))

eww 打不开 reddit 的解决

新版 reddit 重度依赖 JS，eww 渲染不了，改用 old.reddit.com
reddit 会拦截 eww 默认 UA，伪造浏览器 UA：

(setq eww-user-agent "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0 Safari/537.36")

想省流量用移动版：old.reddit.com/r/xxx/.compact
仍打不开就转外部浏览器：C-u M-x eww 可手动选择浏览器

终端模拟

选择

方案	说明
`M-x shell`	仅行程序，不能跑 opencode、vim 等全屏 TUI 程序
`M-x vterm`	最佳 — 基于 libvterm，真正终端模拟，能跑所有 TUI 程序
`M-x ansi-term`	内置，比 shell 好，但部分程序仍有兼容问题
`M-x eat`	纯 elisp 终端，介于 ansi-term 和 vterm 之间

vterm 复制与导航

vterm 中默认按键直接传给子进程，无法用 Emacs 键绑定。

流程： C-c C-t 进入 vterm-copy-mode → 用 Emacs 键（C-s 搜索、C-n/p 上下移动、M-w 复制）→ C-c C-t 或 q 退出。

ansi-term 复制与导航

C-c C-j 切换到 term-line-mode（Emacs 键绑定生效）→ 选文字复制 → C-c C-k 切回 term-char-mode。