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 安装依赖」);更换文件名或安装依赖后重试。具体错误也会记录在输出面板的「操作」通道。

results matching ""

    No results matching ""