概述
Kodus 配置跨三个级别工作:全局、代码库和目录。最具体的级别优先:目录 > 代码库 > 全局
工作原理
字段默认从父级继承。当您在全局级别更改字段时,所有没有覆盖的代码库和目录都会自动更新。覆盖是按字段进行的。您可以覆盖一个字段并继承其他所有字段。
在应用中
- 切换级别: 侧边栏 Code review 分组顶部的范围选择器会列出 Global(“applies to every repository”),然后是每个拥有自身配置的代码库,其目录缩进显示在下方。切换范围时会停留在同一页面(General、What to review、Kody Rules、What Kody writes)。
- 添加级别: 在范围选择器中选择 Add repository configuration。Create repository settings 对话框会让您 Select the target repository,并可选择 Select the target directories;点击 Create settings。参见目录级别设置。
- 查看覆盖: 侧边栏中范围或页面旁的数字徽标统计在该级别被覆盖的设置数量(“N settings overridden at this level”)。在页面上,每个被覆盖的字段都会显示 Overridden 徽标;点击其撤销按钮可让该字段恢复继承。
- 删除级别: 范围选择器旁的 ⋯ 菜单中有 Delete configuration(目录范围下还有 Edit directories)。
示例
- 全局更改传播
- 代码库覆盖
- 返回继承
您在全局级别更改 Minimum severity to post(位于 What to review)。所有没有覆盖的代码库和目录都会自动更新。已覆盖的保持不变。
最佳实践
- 从全局开始设置强大的默认值
- 仅在该代码库/目录有特定需求时才覆盖
常见问题
如果我在全局级别更改某些内容,会破坏我的本地调整吗?
如果我在全局级别更改某些内容,会破坏我的本地调整吗?
不会。本地覆盖保持不变。
我可以只覆盖一个字段并继承其余字段吗?
我可以只覆盖一个字段并继承其余字段吗?
可以。覆盖是按字段进行的。
目录是从代码库还是全局继承?
目录是从代码库还是全局继承?
首先从代码库继承。如果代码库对该字段没有覆盖,则从全局继承。