Doom Emacs 中重复编译问题的分析与解决

问题现象

在使用 Doom Emacs 时，部分用户报告了一个奇怪的现象：每次启动时，系统都会重新编译一些内置的 Emacs Lisp 包，包括 subr-x.el、pcase.el、gv.el、cl-lib.el 等基础库文件。这些编译行为会显著延长启动时间，并且在 Async-native-compile-log 缓冲区中可以观察到重复的编译记录。

技术背景

Emacs 29 版本引入了原生编译(Native Compilation)功能，它能够将 Emacs Lisp 代码编译为本地机器码，而不是传统的字节码。这一功能通过 libgccjit 实现，可以显著提高代码执行效率。编译后的文件通常存储在 ~/.emacs.d/.local/cache/eln/ 目录下，以 .eln 为扩展名。

问题分析

经过技术分析，这种重复编译行为可能有以下几种原因：

1. 环境变量污染：某些环境变量如 EMACSLOADPATH、EMACSPATH 或 EMACSDOC 可能被错误设置，导致 Emacs 无法正确找到或识别已编译的文件。

2. 编译缓存损坏：原生编译缓存目录中的文件可能已损坏或权限不正确，导致系统无法正确读取已编译的文件。

3. 版本不匹配：Emacs 29.4 版本可能存在一些已知的编译相关问题，特别是与某些 Linux 发行版的打包方式有关。

4. 前置加载问题：某些站点级(site-lisp)包可能在 Doom 加载前就加载了这些基础库，导致编译状态不一致。

解决方案

针对这一问题，可以尝试以下解决方案：

1. 清理环境变量：

   doom env clear
   

   这将重置所有与 Emacs 相关的环境变量设置。

2. 重建编译缓存：

   rm -rf ~/.emacs.d/.local/straight/build-*
   rm -rf ~/.emacs.d/.local/cache/eln/*
   doom sync
   

3. 完全重建：

   doom sync --gc --rebuild --aot
   

   这个命令会执行完整的垃圾回收、包重建和提前编译(Ahead-of-Time compilation)。

4. 检查 Emacs 版本： 考虑降级到 29.3 或升级到 30+ 版本，以规避可能的版本特定问题。

深入技术细节

原生编译过程涉及多个关键变量：

• native-comp-jit-compilation：控制即时编译行为
• native-comp-deferred-compilation：控制延迟编译
• native-comp-jit-compilation-deny-list：指定不应编译的包列表

在 Doom Emacs 的配置中，这些变量通常已经过优化设置。如果用户自行修改了这些设置，可能会导致编译行为异常。

结论

虽然这个问题在特定环境下确实存在，但通过上述方法通常可以解决。对于大多数用户而言，清理编译缓存和重建包是最有效的解决方案。如果问题仍然存在，可能需要考虑更深层次的系统配置问题或与特定 Emacs 版本的兼容性问题。

值得注意的是，这类问题通常与特定环境配置相关，而非 Doom Emacs 本身的缺陷。保持 Emacs 和 Doom 的更新，遵循标准的配置实践，可以最大限度地避免此类问题的发生。