Rust工程里有些代码平时看得见,构建时却未必会编进去。例如,固件在开发机上用默认配置构建,发布时才打开某个feature,并切换到板卡的目标架构。如果QAC捕获的是前一条构建命令,分析即使顺利结束,报告也可能缺少发布版才启用的代码。Perforce QAC从2026.1开始支持Rust静态分析。以2026.3的命令行流程为例,分析前要先让QAC跟随实际的Cargo构建,把文件和编译设置同步到分析工程。
一、QAC怎么分析Rust项目
已有C或C++分析工程的团队,可以先核对本机QAC版本和Rust分析组件。Rust代码可以与C、C++代码放在同一个分析工程里,但原有的分析配置不一定已经启用了Rust。
1、确认Rust分析组件和工具链可用
①核对【Perforce QAC】版本,确认已安装配套的【Rust分析组件】。如果还在使用2026.1之前的版本,需先升级到支持Rust的版本。
②按所用QAC版本的要求准备【Rust工具链】及【Clippy】,在项目目录检查rustc--version,并确认当前终端能执行cargo clippy--version。
③进入包含【Cargo.toml】的目录,先独立运行项目平时使用的【cargo build】。如果项目尚未验证过Clippy,也可用同一目标及功能配置单独试跑。
Cargo能找到编译器,只说明工程可以开始构建。若单独运行时就有依赖、目标工具链或链接配置错误,先解决这些问题,后面才容易分辨QAC的同步错误。
2、创建分析工程并运行文件分析
下列命令以当前目录同时作为源码目录和QAC工程目录。已有工程可以直接在原工程上同步。
①在【命令行】运行qacli project create-P.--auto-cct,创建使用自动编译器兼容模板的QAC工程。
②按下一节的步骤运行【qacli sync】,把Cargo构建涉及的文件和编译设置同步进来。
③同步完成后,在【命令行】运行qacli analyze-P.-fc。查看输出中的qarust记录及成功、失败计数,确认目标Rust文件参加了分析。
二、QAC分析Rust项目时怎么采集构建信息
QAC 2026.3对Rust的自动构建同步使用INJECT。它在执行构建命令时采集信息,所以要让Cargo真正发起编译;如果缓存已经满足这次构建,终端显示构建成功,也可能没有捕获到所需的编译调用。
1、用INJECT捕获一次重新构建
①确认当前工作目录包含目标【Cargo.toml】,并在与正常构建一致的终端环境中执行同步。
②在可重新生成构建产物的工作目录运行【qacli sync】:`qacli sync-t INJECT--generate-cct-P."cargo clean&&cargo build"`。请使用半角双引号,把清理和构建作为一条命令传入。
③查看【同步输出】,确认构建执行完成,Rust文件进入工程。`--generate-cct`会在同步时尝试根据捕获的编译器信息生成兼容模板。
2、把发布构建使用的参数一起带上
如果发布流水线会指定目标架构和功能开关,示例里的cargo build就只是起点。实际采集应保留相同的包选择、编译参数和依赖环境。
①对照【CI构建脚本】,确认是否使用-p、`--workspace`、`--target`、`--features`、`--no-default-features`或--release,只保留该工况实际使用的选项。
②将【qacli sync】引号内的构建部分替换为项目实际使用的Cargo命令。工程若依赖【.cargo/config.toml】或RUSTFLAGS,在对应环境中运行同步。
例如,同一个crate可能在桌面构建中使用模拟驱动,在板卡构建中启用实际驱动。两次采集即使都出现lib.rs,分析涉及的条件编译代码也可能不同。复查报告时,最好能找到当时使用的完整构建命令。
三、QAC采集后怎么核对Rust分析范围
同步完成后,可以拿几个明确的目标来验收:发布版的库、指定的可执行程序,或者只有特定功能开启才参与编译的模块。单看文件总数,很难发现漏掉的是哪个范围。
1、工作区少了某个成员,先查构建范围
①在工作区根目录检查【Cargo.toml】里的成员和默认成员设置,核对同步命令是否通过-p只构建了指定包。
②若审查范围确实包含整个工作区,将【cargo build】改为带--workspace的构建命令,重新同步,并核对原先缺少的crate是否进入工程。
2、子模块没单独列出,回到crate根文件确认
①在【QAC工程文件列表】中核对目标crate的根文件,例如src/lib.rs、`src/main.rs`,或清单中另行指定的入口。
②如果根文件存在,而某个子模块未单独列出,在【源文件】中检查该模块是否由根文件导入,以及当前feature或目标条件下是否启用了它。
QAC手工添加Rust文件时,应添加根模块,导入的子模块由分析过程查找。子模块没有单独占一行,不能据此认定它被漏掉;若条件编译把它排除了,把文件硬加到工程里也不能还原原来的构建范围。
3、切换配置后,给结果留下一条可复查的记录
①把【Cargo构建命令】、目标架构和启用的feature随分析结果保存。项目有多个发布配置时,分别标明各轮结果对应的配置。
②对照【qacli analyze】的qarust输出,抽查预期参加分析的crate,并记录未纳入本轮的目标。若需要覆盖另一套配置,按那套命令重新同步并分析。
总结
Rust项目的QAC报告有没有用,可以拿一个问题来检验:看到某段代码没有出现在结果里,能不能解释它当时是否参与了构建?在一个工程同时维护模拟版、板卡版和测试版时,这比只保留告警总数更有价值。把构建命令和报告放在一起,换人复查时就有依据判断:这次是告警修掉了,还是那段代码压根没进本轮分析。