Doom Emacs 新手入门指南

Doom Emacs 新手入门指南

doomemacs An Emacs framework for the stubborn martian hacker 项目地址: https://gitcode.com/gh_mirrors/do/doomemacs

前言

GNU Emacs 作为一款历史悠久的文本编辑器，以其强大的可扩展性和灵活性著称。而 Doom Emacs 则是基于 GNU Emacs 的一个现代化配置框架，它集成了众多优秀插件和合理的默认配置，让用户能够快速获得一个功能强大且高效的开发环境。

本文将带领你完成 Doom Emacs 的完整安装和基础配置过程，涵盖从系统环境准备到个性化定制的各个环节。无论你是 Emacs 新手还是经验丰富的用户，都能从中获得有价值的信息。

系统要求

在开始安装前，请确保你的系统满足以下最低要求：

• Git 2.23+
• Emacs 27.1+（推荐使用 27.2 或支持原生编译的版本）
• ripgrep 11.0+
• GNU Find
• （可选）fd 7.3.0+（在 Debian/Ubuntu 系统中称为 fd-find）

安装步骤

1. 安装 Emacs 及依赖

Linux 系统

Ubuntu/Debian

# 添加 PPA 源
sudo add-apt-repository ppa:kelleyk/emacs
sudo apt update
sudo apt install emacs27

# 安装依赖
sudo apt install ripgrep fd-find

Arch Linux

sudo pacman -S git emacs ripgrep fd

Fedora

sudo dnf install emacs git ripgrep fd-find

macOS 系统

推荐使用 Homebrew 安装：

# 安装依赖
brew install git ripgrep coreutils fd

# 安装 Emacs (推荐 emacs-mac 版本)
brew tap railwaycat/emacsmacport
brew install emacs-mac --with-modules
ln -s /usr/local/opt/emacs-mac/Emacs.app /Applications/Emacs.app

Windows 系统

Windows 用户有三种安装方式可选：

1. 使用 Chocolatey：

choco install git emacs ripgrep fd llvm

2. 手动安装二进制文件：

• 下载并解压 Emacs、ripgrep 和 fd
• 将它们的 bin 目录添加到系统 PATH

3. 使用 WSL：

# 在 WSL 的 Ubuntu 中
sudo add-apt-repository ppa:kelleyk/emacs
sudo apt update
sudo apt install emacs27 git ripgrep fd-find

2. 安装 Doom Emacs

完成基础环境准备后，执行以下命令安装 Doom Emacs：

git clone https://github.com/hlissner/doom-emacs ~/.emacs.d
~/.emacs.d/bin/doom install

安装过程会自动下载和配置所有必要的包，这可能需要一些时间。

基础配置

模块系统

Doom Emacs 采用模块化设计，所有功能都通过模块组织。配置文件位于 ~/.doom.d/ 目录下：

• init.el - 主配置文件，用于启用/禁用模块
• config.el - 自定义配置
• packages.el - 包管理配置

常用操作

1. 更新 Doom Emacs：

~/.emacs.d/bin/doom upgrade
~/.emacs.d/bin/doom sync

2. 回滚到之前版本：

~/.emacs.d/bin/doom rollback

3. 重新编译配置：

~/.emacs.d/bin/doom compile

常见问题解决

1. 调试错误

当遇到问题时，可以：

1. 启用调试模式：

(setq debug-on-error t)

2. 查看详细错误日志：

~/.emacs.d/bin/doom doctor

2. 性能优化

对于 Windows 用户，如果遇到性能问题：

1. 禁用某些图形效果：

(setq doom-themes-enable-bold nil
      doom-themes-enable-italic nil)

2. 减少自动保存频率：

(setq auto-save-default nil)

进阶配置

自定义模块

你可以创建自己的模块，目录结构如下：

~/.doom.d/
└── modules
    └── my-module
        ├── config.el
        ├── init.el
        └── packages.el

然后在 init.el 中启用它：

:my-module

键位绑定

Doom Emacs 使用 general.el 管理键位绑定。示例：

(map! :leader
      :desc "Find file" "f" #'find-file)

结语

Doom Emacs 通过合理的默认配置和模块化设计，大幅降低了 Emacs 的使用门槛。本文介绍了从安装到基础配置的全过程，希望能帮助你顺利开始 Doom Emacs 之旅。随着使用的深入，你可以逐步探索更多高级功能和自定义选项，打造真正属于自己的高效开发环境。

如果在使用过程中遇到任何问题，建议查阅官方文档或社区讨论，那里有丰富的资源和经验分享。

doomemacs An Emacs framework for the stubborn martian hacker 项目地址: https://gitcode.com/gh_mirrors/do/doomemacs