• 一个前提：两种正则语法
• 搜目录下的文件
  • rgrep
  • find-grep-dired
  • find-name-dired / find-lisp-find-dired
  • vc-git-grep
• 搜/替 project
• 搜/替标记的文件（Dired 内操作）
• 搜/替 buffer（IBuffer 内操作）
• tags / xref / eglot
• 安全提醒
• 速查表

所有涉及正则表达式的搜索/替换命令，都需要了解 Emacs 用什么正则语法。总共有两种：

• grep regexp ：命令会调用外部 grep 程序，正则语法跟你用的 grep 版本有关（GNU grep、BSD grep 规则不同）。这类命令包括 rgrep 、 project-find-regexp 、 dired-do-find-regexp
• Emacs regexp ：命令用 Emacs 自己的正则引擎，语法在 help 里查 (info "(elisp) Syntax of Regexps") 。这类命令包括 tags-search 、 dired-do-query-replace-regexp 、 ibuffer-do-*-regexp

两种正则的转义规则不同。不确定的时候，用 M-x re-builder 测试一下你的正则。

rgrep

mkdir -p /tmp/rgrep-demo/src
cat > /tmp/rgrep-demo/src/utils.el <<'EOF'
(defun add (a b) (+ a b))
(defun subtract (a b) (- a b))
;; helper function
(defun multiply (a b) (* a b))
EOF

cat > /tmp/rgrep-demo/src/main.el <<'EOF'
(defun main ()
  (message "hello"))
(defvar *version* "1.0")
EOF

grep -rnH "defun" /tmp/rgrep-demo/src/

/tmp/rgrep-demo/src/main.el:1:(defun main ()
/tmp/rgrep-demo/src/utils.el:1:(defun add (a b) (+ a b))
/tmp/rgrep-demo/src/utils.el:2:(defun subtract (a b) (- a b))
/tmp/rgrep-demo/src/utils.el:4:(defun multiply (a b) (* a b))

find-grep-dired

grep -rl "defun" /tmp/rgrep-demo/src/

/tmp/rgrep-demo/src/main.el
/tmp/rgrep-demo/src/utils.el

find-name-dired / find-lisp-find-dired

find /tmp/rgrep-demo -name "*.el" -type f

/tmp/rgrep-demo/src/main.el
/tmp/rgrep-demo/src/utils.el

vc-git-grep

如果你在 git 仓库里， vc-git-grep 调用 git grep 来搜索。结果展示在 *grep* buffer 里，和 rgrep 一样可以跳转。

project-find-regexp 和 project-query-replace-regexp 是 Emacs 28+ 引入的 project 功能。Emacs 根据 project-vc 自动识别项目根目录（一般就是 git 仓库根目录），不需要你手动指定目录。

• project-find-regexp ：调用外部 grep 搜索整个 project，结果在 *grep* buffer
• project-query-replace-regexp ：在 project 范围内逐一询问替换，用 Emacs regexp。替换时会遍历所有项目文件，每处问你 y/n/!

在 Dired 里用 m 标记了若干文件后，可以对这批文件执行搜索替换。这是最灵活的方式。你可以混选不同目录的文件，不限某个 project。

• dired-do-isearch / dired-do-isearch-regexp ：在标记的文件里递增搜索。 C-s 跳到下一个匹配、 C-r 回退，在所有文件间无缝切换
• dired-do-query-replace-regexp ：在标记的文件里逐一替换（Emacs regexp）
• dired-do-find-regexp ：在标记的文件里搜索，结果展示在 *grep* buffer（grep regexp）。和 dired-do-find-regexp-and-replace 是一对：一个查一个替换
• dired-do-search ：在标记的文件里搜索第一个匹配（Emacs regexp），跳到该文件并高亮

这些都是在 Dired 里 m 标记文件后用的命令，不需要提前退出 Dired。

IBuffer 和 Dired 类似，但它操作的是 buffer 而不是文件。用 m 标记 buffer 后：

• ibuffer-do-isearch / ibuffer-do-isearch-regexp ：在标记的 buffer 里递增搜索
• ibuffer-do-query-replace / ibuffer-do-query-replace-regexp ：逐一替换（普通文本或 Emacs regexp）
• ibuffer-do-occur ：在标记的 buffer 中搜索匹配的行，集中展示在 *Occur* buffer 里

ibuffer-do-occur 特别适合在多个 buffer 里"看一眼哪些行匹配"。结果展示在 *Occur* buffer 里，每条结果可以回车跳转。

这三个不依赖于文件结构或 buffer 列表，而是基于代码语义或 TAGS 文件来搜索替换。

• tags-search ：基于 TAGS 文件的搜索（Emacs regexp）。适合没有 LSP 支持的项目，用 etags~/~ctags 生成 TAGS 文件后就能用
• xref-find-references-and-replace ：搜索并替换所有引用。Emacs 29+ 内置，适合有 TAGS 或 LSP 的项目
• xref-query-replace-in-results ：在 *xref* 结果 buffer 中按 r 触发替换
• eglot-rename ：重命名符号。需要 Eglot（LSP 客户端）支持，选好语言服务器后一键重命名当前符号

批量搜索替换命令就像电动工具：用好了效率翻倍，用砸了麻烦很大。

• 做替换前确认文件已经备份（git commit 或手动备份都行）
• 不确定正则对不对的时候，先用 re-builder 测试
• 部分命令只改 buffer 不自动存盘，替换完成后检查哪些 buffer 是 modified 状态，用 IBuffer 批量保存