Doom Emacs 安装与配置指南

Doom Emacs 安装与配置指南

doomemacs项目地址:https://gitcode.com/gh_mirrors/doo/doom-emacs

1. 项目目录结构及介绍

Doom Emacs 是一个针对 GNU Emacs 的配置框架，它特别设计来满足那些希望减少框架复杂度、追求稳定性和可重复性的高级用户的需要。以下是其基本目录结构及其简介：

• ~/.config/emacs: 这是Doom Emacs的主配置目录，默认情况下，当你通过Git克隆项目时，它会被设置为此路径。
  • init.el: 主要入口点，并非传统意义上的启动文件，因为Doom有自己的机制管理启动流程。
  • packages.el: 包含了你的包管理和自定义包列表。
  • bin: 包含了一些用于管理Doom Emacs的脚本，如doom install, doom sync, 等等。

2. 项目启动文件介绍

在Doom Emacs中，没有一个单一的传统“启动文件”像其他Emacs配置那样直接操作。Doom采用了一种更模块化的方法，主要通过以下几个关键步骤和文件进行初始化：

• init.el: 尽管名为init.el，但它更多地扮演着配置集成了各种模块和个性化设置的角色。用户应该在此文件或相应的.emacs.d/init.el（根据你的克隆位置）中添加个性化的顶层配置指令。

• DOOMRC: 实际上，Doom的启动逻辑位于核心代码库内部，通过一系列的ELisp文件协作完成，而非单一外部启动文件。用户通常不直接编辑这些内部组件，而是通过上述的配置文件间接影响启动过程。

3. 项目的配置文件介绍

Doom Emacs鼓励一种模块化和声明式的配置方式，核心配置并不直接体现在用户级的“启动文件”中。配置主要分布在以下几个方面：

主配置文件

• ~/.config/emacs/init.el 或者克隆仓库内指定位置的同名文件：这是用户放置个性化设置的地方，包括加载特定模块、修改默认行为、添加快捷键等。

包管理配置

• ~/.config/emacs/packages.el：此文件用于列出并控制你想安装的软件包以及它们的状态，比如启用、禁用或者设定特定版本。

模块与个性化配置

Doom Emacs的配置能力强大在于它的模块系统，模块可以被轻松激活或禁用，在init.el中通过(module-enable 'MODULE_NAME)这样的形式启用模块，每个模块可能有其自己的子配置选项。

高级配置

对于更深层次的定制，Doom提供了一系列的钩子(hooks)、变量(variables)和函数(functions)，用户可以通过查阅Doom的官方文档和源码注释来了解如何深入调整。

---

为了开始使用Doom Emacs，您需执行以下步骤：

1. 克隆仓库到~/.config/emacs目录。
2. 在该目录下运行bin/doom install以安装必要的依赖和配置。
3. 根据需要编辑init.el和packages.el文件。
4. 使用Doom命令如doom sync保持配置同步，doom upgrade更新至最新版。

请注意，实际操作前确保已经理解每个命令的作用，避免不必要的配置混乱。

doomemacs项目地址:https://gitcode.com/gh_mirrors/doo/doom-emacs