Checkmarx新项目导入后不识别代码，最常见不是代码真的没进来，而是扫描口径把文件排除了，或者语言模式只扫了某一种主语言，导致你看到的结果像是没有代码。处理这类问题要先确认两件事，第一是文件是否被排除规则与推荐排除挡住，第二是语言识别是否按多语言方式运行，再把过滤规则收敛到你真正要扫的目录与扩展名。

　　一、Checkmarx导入新项目不识别代码怎么办

　　很多团队一上来就反复点扫描，其实更快的办法是按文件范围、排除规则、语言模式三步定位，先把扫描输入修正，再谈规则与结果。

　　1、先确认扫描包里确实包含源码而不是只包含构建产物

　　在你触发扫描的流水线或打包步骤里，先检查工作区是否只剩下编译目录与依赖缓存，确保源码目录在打包前没有被清理；如果是从代码仓库触发，先确认子模块与稀疏检出没有把关键目录漏掉。

　　2、先核对目标语言是否在当前引擎支持范围内

　　到Checkmarx文档的支持语言与文件扩展名列表里核对你项目的主语言与扩展名是否在支持清单中，尤其是用了自定义后缀或把源码放进不常见的扩展名时，识别会直接失败。

　　3、检查是否启用了推荐排除导致源码目录被自动跳过

　　在项目扫描配置里找到【Recommended exclusions】开关，默认开启会套用预定义排除以加快扫描；当你怀疑被误排除时，先把它关掉再跑一次全量扫描，确认是否是推荐排除造成不识别。

　　4、排查文件是否被当作生成文件而被规则自动排除

　　如果你的源码文件头部包含自动生成标记，可能会被生成文件规则排除；把文件顶部注释里类似自动生成、请勿修改这类字样去掉或调整后再试，避免整批文件被当作生成文件跳过。

　　5、把扫描过滤规则先做成最小可用范围

　　在扫描过滤里先只保留核心源码目录，再逐步放开测试与脚本目录；过滤规则支持包含与排除文件类型和文件夹，规则里常用做法是先全局排除再指定需要包含的目录，这样更容易看出是哪一段范围把源码挡住。

　　6、用一次小范围验证扫描确认语言计数是否恢复

　　先用一个只包含少量源码的分支或目录做验证扫描，观察扫描统计里各语言文件数量是否出现，再把范围扩到全仓；这样能把问题从仓库规模与噪声目录里剥离出来，定位会更快。

　　二、Checkmarx语言识别规则怎么调整

　　语言识别的调整核心是两件事，一是语言模式选主语言还是多语言，二是过滤规则决定哪些文件会参与语言统计与扫描。两者配合好，才不会出现看起来没代码或只识别一小部分的情况。

　　1、先把语言模式切到多语言以覆盖多主语言仓库

　　在Checkmarx One里进入【Settings】找到【SAST】再找到【LanguageMode】，把模式设为multi用于扫描多个主语言；如果设为primary，只会按文件数量最多的主语言为主进行扫描。

　　2、当你只想扫某一种语言时再用primary收敛范围

　　单语言仓库或你明确只关心某一语言时，用primary能减少误扫与资源消耗；但切换后要复核是否把其他同仓库语言也一起排除掉了，避免被误解为识别失败。

　　3、用扫描过滤参数把语言识别建立在可控文件集合上

　　在CLI或配置参数里使用sast过滤参数来选择包含或排除的文件类型与文件夹，文档说明过滤支持用逗号串联多条规则，不支持正则；你可以先只包含目标扩展名与核心目录，再逐步增加范围。

　　4、遇到混合仓库先按目录分层建立两套扫描口径

　　把前端、后端、脚本工具链分成不同目录口径分别扫描，或在同一项目里用过滤规则分阶段扫；这样能避免某个目录的大量非核心文件把语言统计拉偏，导致主语言判断与你预期不一致。

　　5、把排除目录的规则写得更贴近真实噪声源

　　优先排除依赖目录、构建输出目录与压缩后脚本目录，再保留源码与配置；文档示例也给出了按文件类型与目录排除的思路，你按这个口径整理会更容易稳定复现。

　　6、调整后用一次全量扫描确认规则没有过度收缩

　　当你改完语言模式与过滤规则，务必跑一次全量扫描验证所有需要的目录都被包含；如果你关闭了推荐排除，也要再评估扫描时间与资源占用，再决定是否只对关键项目长期关闭。

　　三、Checkmarx新项目扫描前怎样把识别与结果做稳

　　把识别做稳的关键不是堆参数，而是把项目结构、过滤口径、验证动作固化成团队标准，后续换仓库或换分支时才能少踩坑。

　　1、建立一份源码目录清单并固定为默认包含范围

　　把真正的源码根目录列出来，作为过滤规则的默认包含项；新项目创建后先按这份清单配置，再根据业务补充测试与脚本目录。

　　2、把文件后缀口径统一避免自定义后缀造成识别缺口

　　对自定义后缀的文件先做重命名或在仓库里统一扩展名策略，确保能落在支持语言的扩展名识别范围内。

　　3、把生成代码与第三方代码的标记管理好

　　生成文件规则会依据常见生成标记排除文件，你需要在仓库里明确哪些目录是生成产物，哪些是手写源码，避免生成标记出现在手写源码头部。

　　4、每次改规则都先做小样本验证再全量推广

　　先拿一个最小目录跑通识别与扫描，再把规则复制到全量项目，避免一次性改动过大导致回退困难。

　　5、把关键配置用配置即代码方式存档便于复用

　　把语言模式、过滤规则、推荐排除开关等关键项以配置方式固化，后续项目复制时直接复用同一口径，减少人为点选差异。

　　总结

　　Checkmarx导入新项目不识别代码，优先从支持语言与扩展名、推荐排除与生成文件排除、以及扫描过滤范围三条线排查，再用小范围验证把识别计数拉回正常。Checkmarx语言识别规则怎么调整，核心是把【LanguageMode】设为适合仓库形态的primary或multi，并用过滤规则把参与识别的文件集合收敛到核心源码目录，调整后再用一次全量扫描确认没有过度排除。