文档同步机制

你会踩进一个非常经典的坑：当你终于写出一个干净的函数签名，测试用例全绿，代码刚刚合并进主干分支，前端同事却在群里敲了一句，“这接口返回的 data.rule_id 是规则ID还是权限ID？文档里写得不清楚。” 你愣了一下，打开所谓的API文档，发现那行描述是三周前写的，现在早就过期了。文档不是没写，是跟不上代码进化的速度。这就是 API 文档永久性不同步困境的真实切片。 如果此时有人告诉你：“用 …