30 分钟跑通 Harper 部署：从克隆仓库到第一份语法检查报告

30 分钟跑通 Harper 部署从克隆仓库到第一份语法检查报告【免费下载链接】harperOffline, privacy-first grammar checker. Fast, open-source, Rust-powered项目地址: https://gitcode.com/GitHub_Trending/har/harper想给英文文档加个语法检查却还没装过 HarperHarper 是 Automattic 出品的 Rust 写的离线语法检查器本地毫秒级出结果Apache-2.0 协议可商用。本文带你完成一次完整的 Harper 部署克隆、编译、lint 出第一份报告再讲清常见报错和输出格式怎么选。一、先判断值不值得装Harper 的能力边界目前只检查英文其他语言要自己扩展核心社区欢迎但别指望开箱即用完全离线文本不出机器不请求任何云端接口隐私敏感场景友好快多数文档在 10ms 内出建议内存占用不到 LanguageTool 的 1/50只给建议不替你改写CLI 前端官方仍标注实验性适合 CI 批量扫描不适合当唯一的质量关卡规则粒度细内置数百条规则可逐条开关也能只跑你关心的那几条如果你要的就是英文文档 本地跑 别传云端那值得装。下面走最短路径。二、最短路径跑通装好 harper-cli 并 lint 第一个文件前置条件只有一个stable 版 Rust 工具链仓库用 edition 2024老版本 rustc 编译不过。克隆仓库git clone https://gitcode.com/gh_mirrors/har/harper cd harper只装 CLI不用编译整个工作区# --path 从仓库内安装该 crate--locked 锁 Cargo.lock 里的依赖版本 cargo install --path harper-cli --locked成功信号~/.cargo/bin下出现harper-cli可执行文件。首遍编译要拉整棵依赖树慢几分钟属正常别当它卡死。然后直接验证——仓库自带demo.md里面埋了几处故意写错的句子harper-cli lint demo.md成功信号首行打印demo.md: N lints随后是带行内上下文的彩色报告能指认出 the the、misspelled 这类错误。到这一步部署已经完成剩下的是选姿势。三、跑通之后怎么选3 种使用姿势场景一行命令代价CI 门禁只看数量harper-cli lint --count .不输出具体问题只报通过与否管道接 grep 等工具harper-cli lint --format compact README.md每条 lint 一行没有源码上下文机器解析harper-cli lint --format json demo.md输出是 JSON得写脚本处理编辑器实时检查改装harper-ls把编辑器 LSP 指过去每个编辑器都要单独配 LSPlint的输入可以是文件、目录或一行字符串什么都不给时读标准输入。姿势定了就看看哪些坑最常见。四、翻车自救常见错误对号入座场景错误表现一句话解法安装失败rustc 报 edition 2024 不可用rustup update升 stable 后重跑装完找不到命令command not found: harper-cli把~/.cargo/bin加进 PATH拼写误报一片文本明明正确却报拼写默认方言是美式us用--dialect换批量报告缩水成数字单行超 150 字符时自动降级单文件跑或加--format compact首次编译极慢源码编译加全量依赖正常等待第二次走缓存⚠️ 易错点千万别直接cargo install harper-cli否则 crates.io 上根本没有这个包名安装直接失败——仓库内安装必须带--path harper-cli。⚠️ 易错点注意--count和--format互斥同时传 CLI 会直接报参数冲突想要机器可读的计数走--format json自己数。坑大多集中在安装阶段装好之后还有几个开关值得调。五、把体验调好一点3 个最值钱的参数--dialect默认us。作用按方言判定拼写与用词选错值会批量误报。方向英式文本切英式方言具体取值以harper-cli lint --help为准--format默认default带源码上下文的彩色报告。作用控制人读还是机器读。方向人看默认流水线用compact对接工具用json--only/--ignore默认全量规则都跑。作用按规则名收窄或排除逗号分隔多个。方向先只开你在意的规则降噪规则名清单用harper-cli config查开关摸清后若想改行为而不是调参数源码就从这几处读起。六、代码指北翻源码先看这 4 个文件harper-cli/src/main.rsCLI 入口所有子命令与参数在这里定义harper-cli/src/lint.rslint 主流程重叠去重和三种输出格式的实现harper-core/dictionary.dict内置词典本体每行一个词/标记harper-core/src/linting/mod.rs全部内置规则的注册表有问题直接去仓库 Issue 提社区对性能类问题尤其敏感。下一篇讲 Harper 的 weirpack怎么把自己的语法规则写成插件挂进去。【免费下载链接】harperOffline, privacy-first grammar checker. Fast, open-source, Rust-powered项目地址: https://gitcode.com/GitHub_Trending/har/harper创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考