模块规则语法大全:modules-graph-assert正则规则写法完全指南与常见误区
模块规则语法大全modules-graph-assert正则规则写法完全指南与常见误区【免费下载链接】modules-graph-assertGradle plugin to keep your modules graph healthy and lean.项目地址: https://gitcode.com/gh_mirrors/mo/modules-graph-assertmodules-graph-assert 是一款让多模块项目依赖图谱保持健康精瘦的 Gradle 插件它的核心就是用regex - regex与regex -X regex这类正则语法编写模块规则约束哪些模块允许相互依赖。本文完整整理正则规则的所有语法要点、匹配细节和常见误区帮助新手一次写对模块依赖护栏避免规则写了却不生效。两种核心规则语法 规则统一配置在moduleGraphAssert代码块中两个属性定义见 GraphRulesExtension.kt属性分隔符语义典型用途allowed-白名单命中任意一条规则才通过整体分层管控restricted-X黑名单命中任意一条规则即失败精准封禁特定路径白名单规则regex - regexallowed左侧是依赖方模块右侧是被依赖方模块两侧都是正则表达式moduleGraphAssert { allowed [ :.* - :core, // 任何模块都可以依赖 :core :feature.* - :lib.* // feature 模块只能依赖 lib 模块 ] }项目中只要出现没有命中任何allowed规则的依赖assertModuleGraph任务就会失败并列出全部违规项校验逻辑见 OnlyAllowedAssert.kt。黑名单规则regex -X regexrestricted使用-X作为分隔符注意 X 是普通字母不是-语义与白名单相反——命中规则的依赖即为违规moduleGraphAssert { restricted [:feature-[a-z]* -X :forbidden-to-depend-on] }匹配与错误信息拼装实现在 RestrictedDependenciesAssert.kt失败时会逐条列出每个违规依赖命中的具体规则定位问题很快。常用正则写法速查表 ⚡想表达的需求规则写法左侧示例任意模块.*任意 feature 模块:feature[a-z]*带冒号前缀的模块:core、:.*feature 或 core 二者之一:(feature\|core)Groovy 中写\|任意数字[0-9]或\dGroovy 中写\\d匹配行为的 3 个隐藏细节 1. 整串匹配不是包含匹配规则生效时依赖对会被拼接成左模块 - 右模块或-X形式的单个字符串然后与你的正则做整串匹配见 RegexpDependencyMatcher.kt。直接推论:feature - :lib只匹配:feature - :lib这一条精确依赖它不会放行:feature2 - :lib需要写成:feature[a-z0-9]* - :lib无需手写^、$锚点默认全串匹配写了也不影响。ParseTest.kt 中有明确的边界用例:feature:[a-zA-Z]* -X :lib能匹配:feature:aboutX -X :lib但匹配不了:feature:aboutX -X :libx。2. 分隔符两侧的空格不能丢-与-X两边各有一个半角空格解析代码 Parse.kt 对子串做严格判断。写成:a- :b或:a - :b会在配置阶段直接抛出Incorrect format. Expected: regexp - regexp构建根本跑不起来。3. 捕获组与反向引用可用规则两侧都支持捕获组Groovy 中用\\1写反向引用反斜杠需双写。项目测试里的经典用法——只允许同一父功能下的兄弟子模块互相依赖allowed [:features:(\\S*):\\S* - :features:\\1:\\S*]这样:features:X:Y - :features:X:Z通过而:features:data:Y - :features:dat:Z被拦截完整示例见 ParseTest.kt。常见误区清单6 个高频坑 ⚠️黑名单用了-分隔restricted必须写-X误写:feature - :lib会直接报格式错误。忘记模块名开头的冒号Gradle 模块名通常形如:core规则里若不统一带上:前缀正则永远匹配不上。误以为allowed为空等于全部禁止allowed、restricted为空时对应断言会被整体跳过见 GraphRulesExtension.kt想收紧图谱必须先写下至少一条规则。忘了 Groovy 反斜杠转义规则字符串里\1、\d、\S都要双写为\\1、\\d、\\S。模块名与别名混用使用moduleNameAssertAlias给模块定型后规则应统一按别名或统一按真实名编写官方明确不推荐混用。断言结果里模块不见了开启 Gradle Configuration On Demand 时部分模块对插件不可见请加--no-configure-on-demand标志运行。进阶玩法按模块类型写规则 ️除了真实模块名还可以为任意模块设置ext.moduleNameAssertAlias Api让allowed/restricted直接按别名匹配。适合扁平化架构将模块分为 Api / Implementation / App 三类规则写成类型级约束allowed [Implementation - Api, App - Implementation, App - Api]渐进式迁移时可将待改造模块临时标为NeedsMigration并为其加上NeedsMigration - .*、.* - NeedsMigration两条豁免规则逐个迁回正式类型该策略详见 README.md。验证命令一条命令守住图谱 ✅规则写完后两种方式验证./gradlew assertModuleGraph ./gradlew check // check 会自动包含 assertModuleGraph如果希望每次构建都自动校验设置assertOnAnyBuild true若还想防止模块依赖退化成长链配合maxHeight 4约束以任一模块为根的依赖树高度即可。掌握了白名单/黑名单两种语法、整串匹配的细节和上表中的误区清单modules-graph-assert 的正则规则基本没有难写的部分。建议先写兜底规则、再逐条收紧让图谱护栏既严格又易维护。【免费下载链接】modules-graph-assertGradle plugin to keep your modules graph healthy and lean.项目地址: https://gitcode.com/gh_mirrors/mo/modules-graph-assert创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

划词翻译 + 生词本:3 步把遇到的单词送进 Anki

划词翻译 + 生词本:3 步把遇到的单词送进 Anki

划词翻译 生词本:3 步把遇到的单词送进 Anki 【免费下载链接】pot-desktop 🌈一个跨平台的划词翻译和OCR软件 | A cross-platform software for text translation and recognition. 项目地址: https://gitcode.com/GitHub_Trending/po/pot-desktop …

2026/10/22 20:28:23 阅读更多 →
LX Music桌面版实战笔记:5个音源聚合,3项设置完成首次配置

LX Music桌面版实战笔记:5个音源聚合,3项设置完成首次配置

LX Music桌面版实战笔记:5个音源聚合,3项设置完成首次配置 【免费下载链接】lx-music-desktop 一个基于 Electron 的音乐软件 项目地址: https://gitcode.com/GitHub_Trending/lx/lx-music-desktop 日常在多个音乐 App 之间找歌、下歌&#xff0c…

2026/10/25 13:56:32 阅读更多 →
基准测试表明,Async Python 远不如同步方式

基准测试表明,Async Python 远不如同步方式

多数人晓得async具备更高的并发性, 这表明针对像动态网站或者Web API这类常见任务, async性能更佳。 然而,令人可惜的是, async 于解释器而言, 并非是一条加速条。 在当下符合实际情况的数据(可查看下图)之中, 异步网络框架的吞吐量&#x…

2026/10/30 7:55:20 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/20 23:27:28 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/20 23:27:28 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/20 23:27:28 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/20 21:55:32 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/20 23:27:28 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/20 22:59:12 阅读更多 →

日新闻

周新闻

月新闻