Emacs 主题 Spacemacs

庸碌无常原创2025/9/20大约 8 分钟

前言

把 Spacemacs 称为主题，完全是我的个人看法。原生的 Emacs 同样可以安装各种插件，实现 Spacemacs 的所有功能。但是插件不是动动小手下载下来就能用的，需要进行配置。而这就是 Spacemacs 的可贵之处。

有一个我在用的 Obsidian 插件，叫做 Spacekeys。该插件用于管理快捷键，插件的灵感来源就是 Spacemacs。这是我和 Spacemacs 最初的渊源。

安装主题

因为事先已经安装过 Emacs，所以我首先把 Emacs 的配置文件 ~/.emacs.d 删除了。除了简单粗暴的删除，也可以重命名备份一下。只不过我完全没有这种打算。

Spacemacs 为进行过配置的 Emacs 用户提供了继承之前配置的选择，具体参考 full installation。

接着就是下载 Spacemac 仓库的 develop 分支，另一条分支 master 已经很久没更新了：

# 下载
git clone https://github.com/syl20bnr/spacemacs $HOME/.emacs.d

Spacemacs 需要一些前置软件才能发挥所有功能：

~~Emacs、git~~，能下载和打开 Spacemacs 说明两者肯定已经安装到位了
Tar，安装和更新 Emacs 包所必需的
Source Code Pro，建议安装该字体，不然有警告
ripgrep，搜索工具

如果你像我一样选择在终端输入 emacs -nw 启动，状态栏可能显示不出来。这时候输入 C-x b 打开缓冲区 *Messages* ，查看启动以来的日志，找到错误信息：

(Spacemacs) Error in dotspacemacs/init: Variable: "dotspacemacs-search-tools" has value: "(rg ag pt ack grep)" that doesn’t match its type\
: "(set (const rg) (const ag) (const ack) (const grep))". Validator message: "(user-error Looking for `(set (const "rg") (const "ag") (con\
st "ack") (const "grep"))' in `("pt")' failed because:                                                                                     
  the following values don't match any of the options:                                                                                     
    pt)"

如果是用快捷方式 Emacs（Termial）启动，状态栏就显示正常。很奇怪。

解决方法是，打开 ~/.spacemacs.d/init.el ，找到 dotspacemacs-search-tools ，把搜索工具 pt 删除。看注释的意思是，会优先选前面的搜索工具，如果没安装，就选下一个，理论上安装了 rg ，即 ripgrep 就不该报错。

更新主题

更新 Spacemacs 仓库：

# 关闭 emacs 并手动 git 更新
git pull --rebasZe

更新软件包：`M-x configuration-layer/update-packages

回滚软件包更新：M-x configuration-layer/rollback

M-x 是 Emacs 的命令前缀，在 Spacemacs 中可以用 <SPC> <SPC> 代替。

阅读 init.el

Spacemacs 接管了 ~/.emacs.d ，我们不需要关心这个文件夹下面是怎样的——Spacemacs 为用户配置提供了 ~/.spacemacs.d 文件夹。初次安装，只有一个 init.el 文件。

init.el 源代码有着丰富的注释，在开始正式攻略 Spacemacs 官方文档前，先耐心的翻看一遍，我会挑选一些设置进行记录。

init.el 的代码结构是由6个函数组成：

dotspacemacs/layers：启用/禁用 layer 和软件包
dotspacemacs/init：在 Emacs 启动时加载，用于配置 Spacemacs
dotspacemacs/user-env：加载环境变量
dotspacemacs/user-init：初始化加载软件包所需的变量
dotspacemacs/user-config：用于添加个人的自定义配置、键绑定、函数定义等
dotspacemacs/emacs-custom-settings：Spacemacs 自动生成，用户不能改动

user-env 函数默认加载 ~/.spacemacs.env 文件，该文件下有各种 shell 中的环境变量，比如 conda 路径、Java jdk、shell 类型、proxy 地址等等。

函数的调用顺序为：init -> user-init -> layers -> user-config -> emacs-custom-settings。

主要查看前两个函数，user-env 没什么好看的，user-init 和 user-config 是用户自定义区域，初始为空。最后一个函数，是我在软件仓库（快捷键 M-x list-packages ）安装软件包时候，自动生成的。通过软件仓库安装的包，会被 .spacemacs.d 覆盖，所以看上去是装上了，实则没有，要在 .spacemacs.d/init.el 的 additional-packages 中添加包名。

layers 函数

layer 是 Spacemacs 提供的一个抽象。Spacemacs 把一组功能联系紧密的插件放到一起，然后帮你配置好它的各种烦碎细节，给你提供总体上的某个功能。
比如说，auto-completion 层提供自动补全功能，org 层给你 org-mode 的良好使用体验，C/C++层能让你迅速把 Emacs 变成 C/C++的 IDE 等等。