jetbrains/qodana-jvm

Qodana for JVM 镜像文档

1. 镜像概述和主要用途

Qodana for JVM 是 JetBrains 官方推出的 Docker 镜像，专为 JVM 项目提供代码质量分析解决方案。基于 JetBrains 深厚的 IDE 技术积累，该镜像可对 Java、Kotlin 等 JVM 语言项目进行静态代码分析、质量检查及问题检测，帮助开发团队在开发流程中快速识别代码缺陷、优化代码结构，提升整体代码质量。

2. 核心功能和特性

• 官方支持：JetBrains 官方维护项目，与 IntelliJ IDEA 等 IDE 技术同源，分析规则精准可靠。
• JVM 项目适配：专为 Java、Kotlin 等 JVM 语言项目优化，支持主流构建工具（如 Maven、Gradle）。
• 静态代码分析：集成代码质量检查、代码风格验证、潜在缺陷识别等核心能力。
• 灵活集成：可无缝接入本地开发环境或 CI/CD 流程，支持自动化代码质量管控。

3. 使用场景和适用范围

• 开发团队：在代码提交前或代码审查阶段进行本地质量自检，提前发现问题。
• CI/CD 流程：集成至 Jenkins、GitHub Actions 等持续集成工具，实现每次构建的自动化代码质量把关。
• 项目维护：对 legacy 项目进行批量代码质量扫描，定位优化点。
• 教育场景：辅助开发者学习规范编码风格，提升代码规范性。

4. 使用方法和配置说明

4.1 基本使用

前提条件

• 已安装 Docker 环境。
• 待分析的 JVM 项目目录可被 Docker 访问。

快速启动命令

通过以下命令启动容器，对本地项目进行分析：

bash
docker run --rm \
  -v <本地项目绝对路径>:/data/project \  # 挂载项目目录至容器内
  jetbrains/qodana-jvm                   # 镜像名称

分析结果默认生成在容器内 /data/results 目录，可通过额外挂载目录持久化结果：

bash
docker run --rm \
  -v <本地项目路径>:/data/project \
  -v <本地结果路径>:/data/results \    # 挂载结果目录
  jetbrains/qodana-jvm

4.2 详细配置

更多配置参数（如指定分析范围、自定义规则集、输出格式等）请参考官方用户指南：
Qodana for JVM 用户指南

5. 许可证信息

• 使用 Qodana Docker 镜像即表示您同意 JetBrains 隐私政策。
• EAP（早期访问版）镜像包含评估许可证，有效期为 30 天，需定期拉取最新镜像以延续使用。
• 镜像中第三方软件的许可证信息详见 JetBrains 第三方软件许可页面。
• 镜像构建相关的 Dockerfile 开源托管于 https://github.com/JetBrains/qodana-docker/tree/main 仓库。

6. 联系与反馈

如有使用问题或功能建议，可通过以下方式联系：

• 邮件：***
• Issue 跟踪器：JetBrains YouTrack

我们欢迎您的反馈，以持续优化工具功能与用户体验。