目录
- 安装 harper-ls
- snap 安装（不推荐，版本严重滞后）
- Cargo 安装（推荐）
- Emacs 配置
- 通过 eglot 集成
- snap 安装还需要加路径
Harper 是一个开源的英语语法检查器，用 Rust 编写。它通过 Language Server Protocol（LSP）提供服务，装好 harper-ls 之后 Emacs 就能通过 eglot 接上
它。
和 Grammarly 最大的区别是 Harper 在本地运行，不把文本发到云端。不想开浏览器查语法、不想让 Grammarly 扫描私人邮件的，用这个正合适。虽然它不如 Grammarly 全面，日常拼写和语法检查够用了。
安装 harper-ls
Harper 官方主要支持 macOS（Homebrew）和 Arch Linux。Ubuntu 系有两个选择：
snap 安装（不推荐，版本严重滞后）
sudo snap install harper --edge
这个 snap 包由第三方维护，目前还是 0.49，官方已经到 2.2.1 了。只是偶尔用一下还行，版本差这么多，bug 和功能缺失都少不了。
Cargo 安装（推荐）
Emacs 配置
通过 eglot 集成
(with-eval-after-load 'eglot (add-to-list 'eglot-server-programs '(org-mode . ("harper-ls" "--stdio")))) (setq-default eglot-workspace-configuration '(:harper-ls (:dialect "American" :linters (:LongSentences :json-false :AvoidCurses :json-false))))
配置说明，
- 选择美式英语
- 关闭长句子检查，Harper 会优先把长句标成"太长"，句子内部的其他错误（拼写、用词、语法）就被盖住了，改完长句才能看到
- 关闭不当用语检查，Harper 会标记脏话等，大部分人不需要这个
- 完整的 linter 选项见 https://writewithharper.com/docs/rules
snap 安装还需要加路径
如果你用 snap 装的，Harper 不在标准 PATH 里，需要手动加一下，
(when (eq system-type 'gnu/linux) (add-to-list 'exec-path "/snap/harper/current/bin"))
用 Cargo 装的不需要这步，=harper-ls= 已经在 PATH 里了。