TIL: 在 Emacs 中使用 Harper 语法检查器
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 安装(推荐)
cargo install harper-ls
要装 Rust 环境,但至少拿到的是最新版。
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 里了。