9.6 配置项与限制
9.6.1 配置项
配置项位于 VSCode 设置中(settings.json 中的 udm.analysis.*),修改后下次分析立即生效,无需重启。
| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
udm.analysis.enableAutoAnalyze |
布尔 | true |
项目加载、BOM 变更或文件保存后是否自动执行依赖分析与循环检测 |
udm.analysis.maxCyclesPerGroup |
数值(1–200) | 20 |
单个强连通分量内允许枚举的最大循环数量,用于避免复杂项目中环链数量爆炸 |
udm.analysis.blockOnDeploy |
布尔 | true |
部署或编译打包前是否执行依赖校验,并在发现问题时弹出确认 |
udm.analysis.maxNodes |
数值(≥100) | 20000 |
依赖图节点数上限,超过后降级为仅输出统计信息 |
9.6.2 分析范围
| 参与分析 | 不参与分析 |
|---|---|
.brl / .jbrl、.dta / .jdta、.dtr / .jdtr、.sca / .jsca、.rfl / .jrfl |
变量集(.var)、BOM(.bom)、测试用例(.tst)等非规则文件(BOM 仅用于业务对象继承分析) |
| 工程内的规则包目录 | 服务器上已发布的规则应用、以及工程外的文件 |
9.6.3 限制与注意事项
| 限制 | 说明 |
|---|---|
| 规模降级 | 节点数超过 maxNodes 时只输出统计,不建图、不输出引用关系与问题;报告面板顶部显示降级原因,依赖分析的 Problems 结果也会被清空。可调大上限后重新分析 |
| 环数量上限 | 每个强连通分量最多枚举 maxCyclesPerGroup 个环,环特别密集的工程可能只列出部分环(短环优先展示),可调大该值 |
| 规则应用不计入问题 | 决策流引用的规则应用发布在服务器上,工程内没有对应文件,只作信息展示 |
| 外部父类不告警 | 父类未在 BOM 中声明时按运行期 JVM 类处理,只在「业务对象继承」区块列出,不产生诊断 |
| 循环继承定位 | 无法映射到具体 BOM 文件的继承链不会进入 Problems 与问题清单,只在报告面板中展示 |
| 规则包解析 | 点分包名按路径后缀匹配,取层级最浅的目录;目录未纳入工程文件清单、或被隐藏排除时,可能被判定为悬空引用并提示缺少 .rulepackage |
| 语法错误 | 文件内容解析失败时跳过该文件的引用提取,由语法诊断给出具体错误,二者不重复提示 |
| 定位精度 | 悬空引用的行列由引用文本检索得出,同一引用值多次出现时按出现顺序定位,可能与人工预期位置略有偏差 |
9.6.4 常见问题
1)报告面板为空或统计为 0
确认已在 VSCode 中打开 UDM 规则工程;工程首次加载时文件清单尚未扫描完成,可稍等片刻后点击【重新分析】。
2)修改文件后面板没有变化
自动分析可能被关闭(udm.analysis.enableAutoAnalyze 为 false),或文件尚未保存;保存文件或点击【重新分析】即可。
3)提示悬空引用,但目标文件确实存在
依次检查:目标目录是否被插件隐藏或排除、规则包目录是否缺少 .rulepackage 文件、是否存在两个文件使用同一 UUID(UUID 重复会退化为按路径识别节点)、规则包名书写是否与实际目录层级匹配。
4)业务对象继承区块提示外部父类
这是信息项,通常说明父类来自运行期 classpath(jar)中的 Java 类,不影响编译与部署,无需处理。
5)循环依赖是否必须修复
分析结果为错误级,理论上应修复。若业务上确需保留(例如设计上的双向引用),部署时在确认框中选择【仍然继续】即可,或将 udm.analysis.blockOnDeploy 设为 false 关闭拦截。
6)导出 Excel 失败
常见原因是目标文件被 Excel 占用,或本地缺少 exceljs 依赖(提示「未找到 exceljs,请先执行 npm install 安装依赖」);更换文件名或安装依赖后重试。具体错误也会记录在输出面板的「操作」通道。