用途:为项目定制 Codacy 配置。它先发现仓库的语言与框架,用 init --auto 初始化覆盖面较广的工具与模式,运行分析查看完整问题分布,再依据严重级别与类别分布决定禁用或调整哪些模式,最终得到干净、高信号的配置,并保留变更原因记录。
主要能力:本地配置全部通过 .codacy/codacy.config.json 完成,编辑后运行分析即可看到结果,无需推送或云端重分析;调优后可一步导入 Codacy Cloud。支持三种调用模式:交互(默认,调优后询问是否导入)、自动导入(参数含 import)、仅本地(仓库不在 Cloud 时)。force 参数控制导入时遇到 Coding Standard 冲突是否自动用 --force 重试。
使用方式:需 Codacy Analysis CLI(codacy-analysis,支持 discover 与 init --auto)和 Codacy Cloud CLI(codacy);若 CLI 不支持相关命令,可运行 npm i -g @codacy/analysis-cli 更新。两个 CLI 共用 ~/.codacy/credentials 凭据。工作流分七步:检查环境并采集基线、发现仓库技术栈、初始化自动配置、运行广泛配置基线分析、智能噪声评估与调优、展示本地结果、按条件导入云端、清理。常用命令包括 codacy-analysis discover、codacy-analysis init --auto、codacy-analysis analyze --install-dependencies --output-format json --output <file>,以及 codacy repository、codacy tools、codacy issues 等。
限制:组织级 Coding Standard 强制的模式无法在仓库级修改;本地配置文件仅用于本地分析,提交或推送对 Codacy Cloud 分析无效,需用导入命令应用;init --remote 在配置文件已存在时会失败,需先删除;CLI 进度信息写入 stderr,管道传给 jq 时需重定向。安全类模式与 Critical/High 严重级别模式不会被预先禁用。