07-开发 on 编程那些事儿

01-基础

Sat, 22 Aug 2026 18:00:00 +0800

译文 · 基于 Clippy Documentation

基础

原文链接: https://doc.rust-lang.org/nightly/clippy/development/basics.html

本文说明参与 Clippy 开发所需的基础知识，包括如何构建与测试 Clippy 等。若要更深入地了解代码库，请参阅添加 Lint 或常用工具。

参与 Clippy 开发的基础

获取代码

首先确保已检出 Clippy 的最新版本。若这是你第一次参与 Clippy 开发，请先 fork 仓库，再用以下命令克隆：

02-添加 Lint

Sat, 22 Aug 2026 18:00:00 +0800

译文 · 基于 Clippy Documentation

添加 Lint

原文链接: https://doc.rust-lang.org/nightly/clippy/development/adding_lints.html

你很可能是因为想为 Clippy 添加新 lint 才来到这里。若这是你第一次为 Clippy 做贡献，本文将引导你从零开始创建一个示例 lint。

我们将创建一个检测名为 foo 的函数的 lint，因为显然这不是一个描述性的名称。

03-定义 Lint

Sat, 22 Aug 2026 18:00:00 +0800

译文 · 基于 Clippy Documentation

定义 Lint

原文链接: https://doc.rust-lang.org/nightly/clippy/development/defining_lints.html

新 lint 旅程的第一步，是在 Clippy 代码库中定义并注册该 lint。由于涉及一些样板代码，可使用 Clippy 开发工具完成这一步。

Lint 类型

lint 类型指你的 lint 所关注的项与表达式的类别。

04-编写测试

Sat, 22 Aug 2026 18:00:00 +0800

译文 · 基于 Clippy Documentation

编写测试

原文链接: https://doc.rust-lang.org/nightly/clippy/development/writing_tests.html

为 Clippy 开发 lint 是测试驱动开发（TDD）过程，因为在实现任何新 lint 逻辑之前，我们的首要任务是编写测试用例。

用测试开发 Lint

开发 Clippy 时，我们进入充满程序问题、风格错误、不合逻辑代码与违反惯例的复杂领域。测试是我们能利用的第一层秩序，用来定义新 lint 应在何时、何地触发或不触发。

05-Lint 遍历

Sat, 22 Aug 2026 18:00:00 +0800

译文 · 基于 Clippy Documentation

Lint 遍历

原文链接: https://doc.rust-lang.org/nightly/clippy/development/lint_passes.html

在实现新 lint 的逻辑之前，每位 Clippy 开发者都要做一个重要决定：使用 EarlyLintPass 还是 LateLintPass。

简而言之，LateLintPass 可访问类型与符号信息，而 EarlyLintPass 不能。若不需要类型信息，请使用 EarlyLintPass。

06-发出 Lint

Sat, 22 Aug 2026 18:00:00 +0800

译文 · 基于 Clippy Documentation

发出 Lint

原文链接: https://doc.rust-lang.org/nightly/clippy/development/emitting_lints.html

在定义 lint、编写 UI 测试并选择 lint pass之后，即可开始实现 lint 逻辑以发出 lint，逐步使 lint 行为符合预期。

注意本章不会深入具体 lint 逻辑的实现，细节将在后续章节及两个真实 Clippy lint 示例中讲解。

07-类型检查

Sat, 22 Aug 2026 18:00:00 +0800

译文 · 基于 Clippy Documentation

类型检查

原文链接: https://doc.rust-lang.org/nightly/clippy/development/type_checking.html

开发新 lint 或改进现有 lint 时，我们可能出于多种原因需要获取表达式 Expr 的类型 Ty。这可以通过 LateLintPass 可用的 LateContext 实现。

`LateContext` 与 `TypeckResults`

lint 上下文 LateContext 与 TypeckResults（由 LateContext::typeck_results 返回）是 LateLintPass 中最有用的两个数据结构。它们让我们能跳转到类型定义及其他编译阶段（如 HIR）。

08-Trait 检查

Sat, 22 Aug 2026 18:00:00 +0800

译文 · 基于 Clippy Documentation

Trait 检查

原文链接: https://doc.rust-lang.org/nightly/clippy/development/trait_checking.html

除类型检查外，实现 lint 时我们可能还想检查特定类型 Ty 是否实现了某 trait。有三种做法，取决于目标 trait 是否有诊断项（diagnostic item）、语言项（lang item），或两者皆无。

09-方法检查

Sat, 22 Aug 2026 18:00:00 +0800

译文 · 基于 Clippy Documentation

方法检查

原文链接: https://doc.rust-lang.org/nightly/clippy/development/method_checking.html

开发 lint 时，某些场景下需要检查方法。我们可能关心两类问题：

调用：表达式是否调用了特定方法？
定义：impl 是否定义了某方法？

检查 `expr` 是否调用特定方法

假设有 expr，可通过匹配 expr.kind 中的 ExprKind 判断是否调用特定方法（如 our_fancy_method）：

10-宏展开

Sat, 22 Aug 2026 18:00:00 +0800

译文 · 基于 Clippy Documentation

宏展开

原文链接: https://doc.rust-lang.org/nightly/clippy/development/macro_expansions.html

在 Clippy 中工作时，有时会遇到 Rust 宏展开。宏展开虽不如宇宙膨胀那般宏大，却可能为代码与逻辑的秩序世界带来混乱。

一般原则是：在 Clippy 中应忽略来自宏展开的代码，因为这类代码可能以难以或无法预见的方式动态变化。

11-常用工具

Sat, 22 Aug 2026 18:00:00 +0800

译文 · 基于 Clippy Documentation

常用工具

原文链接: https://doc.rust-lang.org/nightly/clippy/development/common_tools_writing_lints.html

编写 lint 时可能需要以下提示以掌握常见操作。

编写 lint 的常用工具

有用的 Rustc 开发指南链接：

获取表达式的类型

有时需要获取表达式 Expr 的类型 Ty，例如回答：

14-团队

Sat, 22 Aug 2026 18:00:00 +0800

译文 · 基于 Clippy Documentation

团队

原文链接: https://doc.rust-lang.org/nightly/clippy/development/the_team.html

每一位为 Clippy 做贡献的人，都在塑造这个项目。协作与讨论是每个开源项目的命脉。Clippy 的层级非常扁平，团队主要拥有额外的仓库访问权限。

07-开发 on 编程那些事儿

01-基础

基础

获取代码

02-添加 Lint

添加 Lint

03-定义 Lint

定义 Lint

Lint 类型

04-编写测试

编写测试

用测试开发 Lint

05-Lint 遍历

Lint 遍历

06-发出 Lint

发出 Lint

07-类型检查

类型检查

LateContext 与 TypeckResults

08-Trait 检查

Trait 检查

09-方法检查

方法检查

检查 expr 是否调用特定方法

10-宏展开

宏展开

11-常用工具

常用工具

获取表达式的类型

14-团队

团队

`LateContext` 与 `TypeckResults`

检查 `expr` 是否调用特定方法