PAYATHON 2026

IfThisThenThat Lint（IFTTT）在项目中有哪些实际应用场景？

数据小陈

IfThisThenThat Lint 适合处理这类维护问题：修改一处内容时，另一个文件或代码块也需要同步调整，而编译器无法直接检查这种关系。

它通过注释声明修改依赖，再检查相关内容是否在同一次变更中更新。它不会自动推导并替换另一处内容。Chromium 的指南将其定位为跨语言、目录或团队边界的同步检查工具。Chromium 使用指南

哪些场景适合使用？

以下场景可以考虑使用它，但并不是所有项目都需要引入：

  • 跨语言维护同一份数据定义：例如后端使用 Go，前端手写 TypeScript 类型。新增响应字段时，需要提醒维护者检查另一端。
  • 代码参数与文档对应：例如修改上传大小或请求超时限制后，需要同步更新接口文档和配置说明。
  • 成对维护的实现：例如序列化和反序列化代码分别维护，修改格式时应同时检查两边。

在 ifttt-lint 仓库中，项目用自己的指令关联 Cargo.toml、pre-commit 配置和 CI 发布流程中的工具版本，防止手动修改绕过正常的版本同步流程。项目 README

如何声明同步关系？

以修改超时设置时同步更新配置文档为例。以下文件名和数值仅用于演示。

config.py：

# LINT.IfChange(request_timeout)
REQUEST_TIMEOUT_SECONDS = 20
# LINT.ThenChange(//docs/config.md:request_timeout)

docs/config.md：

<!-- LINT.IfChange(request_timeout) -->
请求超时时间为 20 秒。
<!-- LINT.ThenChange(//config.py:request_timeout) -->

LINT.IfChange 标记受监控区域的起点，LINT.ThenChange 标记终点并指定关联目标。这里的 // 表示仓库根目录，冒号后面是目标区域的标签。两个方向都声明依赖，才能分别检查两边发起的修改。路径和标签的具体写法见开源实现的指令语法。

在项目中怎样落地？

  1. 找出曾经发生漏改、且确实需要一起维护的内容，先选择少量位置添加标记。
  2. 将受监控区域缩小到相关内容，避免整个文件的任意修改都触发提醒。
  3. 在 CI 中启用基于 diff 的同步检查，并确保比较范围覆盖完整的提交或 PR。

接入时要区分两种检查：结构检查确认指令、路径和标签是否有效；diff 检查用于确认关联内容是否一起修改。开源实现分别提供这两类能力。检查模式说明

使用时有哪些限制？

检查通过只能说明关联位置被修改过，不能证明修改后的含义一致。例如，代码中的超时改成 30 秒，文档却误写成 40 秒，这类问题仍需要通过测试或代码审查发现。

如果能通过共享模块、统一 schema 或代码生成消除两处内容的重复，应优先评估这些方案。对于暂时必须手动维护的关联内容，可以用 IFTTT Lint 提醒漏改，但它不能替代测试和基本的 DRY 原则。Chromium 使用指南

备注：内容仅供参考。