Windows平台Emacs 29.1中Evil-mode无法正常启动问题求助

问题背景 #

在Windows上安装Emacs 29.1后，通过ELPA安装Evil-mode，启用时弹出编译警告：

Warning (comp): evil-vars.el:561:25: Warning: the function `evil-delete-backward-word' is not known to be defined.

该警告来自Evil包的evil-vars.el文件，原因是Emacs 29的字节编译机制对未定义函数的检查更严格，而evil-delete-backward-word实际定义在evil-insert-state.el中，加载顺序或编译时未被识别。以下是无需降级Emacs的解决方案：

可行解决方案 #

1. 调整Evil加载顺序

在配置文件中先加载定义evil-delete-backward-word的evil-insert-state模块，再加载Evil核心：

(require 'evil-insert-state)
(require 'evil)
(evil-mode 1)

这样字节编译器在处理evil-vars.el时，已经知道该函数的存在，不会触发警告。

2. 声明函数存在

用declare-function告诉字节编译器该函数的定义位置，提前消除警告：

(declare-function evil-delete-backward-word "evil-insert-state.el")
(require 'evil)
(evil-mode 1)

这个方法无需调整加载顺序，仅通过声明让编译器忽略未定义检查。

3. 重新编译Evil包

卸载当前Evil包后，重新安装并编译：

1. 执行M-x package-delete，选中evil包卸载；
2. 执行M-x package-refresh-contents更新包索引；
3. 重新安装Evil；
4. 执行M-x byte-recompile-directory，选择Evil的安装目录（如~/.emacs.d/elpa/evil-20240716.1100），确认编译整个目录。
   重新编译会正确处理包内的依赖关系，解决编译警告。

4. 临时关闭编译警告（不推荐）

如果只是想临时屏蔽警告，可在配置中添加：

(setq comp-async-report-warnings-errors nil)

注意：这会关闭所有编译阶段的警告和错误提示，可能错过其他潜在问题，仅作为应急方案。

为什么Emacs 27无此问题 #

Emacs 27的字节编译机制对未定义函数的检查较为宽松，即使函数在后续加载的文件中定义，也不会触发警告；而Emacs 29加强了编译时的静态检查，因此出现该提示。

内容的提问来源于stack exchange，提问作者Bryan Yep