AI Coding Tools 文档

简体中文

English

简体中文

English

主题

如何使用 Kiro 进行 Java 开发 ​

Kiro 为 Java 项目提供强大的 AI 辅助开发能力，帮助您更高效地编写、调试和维护 Java 代码。

前置条件 ​

在开始使用 Kiro 进行 Java 开发之前，请确保您已安装：

  • Java Development Kit (JDK)：安装最新的 LTS 版本（推荐 JDK 17 或更新版本）。我们推荐使用 Amazon Corretto，这是一个免费的、生产就绪的 OpenJDK 发行版。
  • 构建工具：Maven 或 Gradle 用于依赖管理和构建自动化。
  • Git：用于版本控制和协作。

扩展插件 ​

Kiro 支持来自 Open VSX 的扩展插件，可以增强您的 Java 开发体验。以下是一些有用的扩展插件：

核心扩展 ​

  • Extension Pack for Java：Visual Studio Code 中流行的 Java 开发扩展包。包括 Java 语言支持、Java 调试器、Java 测试运行器、Maven for Java、Java 项目管理器和 IntelliCode。

框架特定扩展 ​

  • Spring Boot Extension Pack：Spring Boot 开发扩展集合，包括 Spring Boot Tools、Spring Initializr Java Support 和 Spring Boot Dashboard。

构建工具扩展 ​

  • Gradle for Java：管理 Gradle 项目，运行 Gradle 任务，并在 Kiro 中提供更好的 Gradle 文件编写体验。
  • Maven for Java：管理 Maven 项目，运行 Maven 任务，并在 Kiro 中提供更好的 Maven 项目编写体验。

其他有用扩展 ​

  • Markdown Preview Enhanced：用于查看和编辑 markdown 文件，支持实时预览。

您可以通过扩展面板搜索上述扩展名称来在 Kiro 中安装这些扩展。

环境配置 ​

通过 Kiro，您可以利用聊天功能来设置新项目或处理现有项目。

项目配置和结构 ​

Kiro 可以帮助您设置和维护 Java 项目的配置文件，并按照 Java 最佳实践组织项目：

  • 初始化配置文件：要求 Kiro 根据项目初始化默认配置文件
  • 创建项目结构：要求 Kiro 根据需求和最佳实践创建项目结构
  • 环境设置：获取配置 Java 开发环境的帮助

示例提示语： ​

"创建一个新的 Maven 项目用于 Spring Boot 应用"
"设置一个包含 JUnit 5 和 Mockito 依赖的 Gradle 构建文件"
"配置一个多模块 Maven 项目结构"
"帮我为我的操作系统安装和配置最新的 JDK"
"设置一个具有适当分层架构的 Spring Boot 项目"
"创建一个包含 Spring Security 和 JPA 依赖的 pom.xml"

代码分析和重构 ​

Kiro 可以分析您的 Java 代码以识别问题并提出改进建议：

功能特性 ​

  • 代码质量分析：要求 Kiro 检查您的代码以发现潜在的错误、性能问题或样式问题
  • 重构协助：获取提取方法、重命名变量或重构代码的帮助
  • 设计模式实现：Kiro 可以帮助在您的 Java 代码中实现常见的设计模式

示例提示语： ​

"分析这个方法的潜在错误或性能问题"
"重构这段代码以使用建造者模式"
"将这段命令式代码转换为使用 Java Streams"

调试协助 ​

当您在 Java 代码中遇到错误时：

调试功能 ​

  • 错误解释：Kiro 可以用通俗易懂的语言解释晦涩的错误消息
  • 解决方案建议：获取常见错误的可操作修复方案
  • 运行时调试：Kiro 可以帮助设置调试配置

示例： ​

"解释我代码中的这个 NullPointerException"
"帮我调试这个 ConcurrentModificationException"
"分析这个堆栈跟踪并建议修复方案"

智能引导 (Steering) ​

智能引导允许您为 Kiro 提供项目特定的上下文和指导原则。Kiro 可以生成您可以完善的引导文件：

核心引导文件 ​

  • 产品简介 (product.md)：包含产品信息、目的和关键特性
  • 技术栈 (tech.md)：详细说明技术、框架和开发指导原则
  • 项目结构 (structure.md)：提供项目组织方式的信息

创建自定义引导文件 ​

  1. 导航到侧边栏中的 Kiro 视图
  2. 在 Agent Steering 部分，选择 + 按钮创建新的引导文件
  3. 输入具有描述性标题的文件名
  4. 按照 markdown 约定添加您的自定义引导内容

自定义引导文件存储在 .kiro/steering/ 目录中，并在交互过程中被 Kiro 自动识别。

项目特定约定 ​

创建 java-conventions.md 引导文件来定义您团队的特定实践和架构决策：

markdown
# Java 项目约定

## 架构模式
- 对复杂域使用六边形架构
- 在需要时实现 CQRS 进行读写分离
- 为业务逻辑应用领域驱动设计原则

## 测试策略
- 为所有业务逻辑编写单元测试
- 使用 TestContainers 进行集成测试
- 维持最低 80% 的代码覆盖率
- 遵循 AAA 模式（Arrange, Act, Assert）

## 错误处理
- 为业务逻辑错误使用自定义异常
- 使用 @ControllerAdvice 实现全局异常处理器
- 使用关联 ID 记录错误以便跟踪
- 返回一致的错误响应格式

## 性能指导原则
- 为数据库访问使用连接池
- 为频繁访问的数据实现缓存策略
- 为长时间运行的操作使用异步处理
- 监控和优化数据库查询

框架特定指导原则 ​

对于 Spring Boot 项目，创建 spring-boot-patterns.md 引导文件：

markdown
# Spring Boot 开发指导原则

## 组件结构
- 使用 @RestController 用于 REST 端点
- 使用 @Service 用于业务逻辑
- 使用 @Repository 用于数据访问
- 使用 @Component 用于其他 bean

## 依赖注入
- 优先使用构造函数注入而非字段注入
- 为注入的依赖使用 final 字段
- 避免循环依赖

## API 设计
- 遵循 REST 原则进行端点设计
- 使用适当的 HTTP 方法（GET、POST、PUT、DELETE）
- 返回适当的 HTTP 状态码
- 为请求/响应对象使用 DTO

Agent Hooks ​

Kiro 的 Agent Hooks 可以自动化常见的 Java 开发任务。例如，您可以创建以下钩子：

  • 保存 Java 文件时自动生成 JUnit 测试
  • 使用 Checkstyle 或 SpotBugs 运行代码质量检查
  • 检查过时的 Maven 或 Gradle 依赖
  • 为公共方法生成或更新 JavaDoc 注释
  • 验证 Spring Boot 配置文件
  • 使用 Google Java Format 或类似工具格式化代码

MCP 服务器 ​

Kiro 对模型上下文协议 (MCP) 服务器的支持通过提供专门的工具和功能来增强您的 Java 开发体验。

Maven MCP 服务器 ​

Maven MCP 服务器允许您直接在 Kiro 中管理 Maven 项目：

json
{
  "mcpServers": {
    "maven": {
      "command": "uvx",
      "args": ["maven-mcp-server@latest"]
    }
  }
}

配置此服务器后，您可以：

  • 使用 Kiro 运行 Maven 命令
  • 获取构建问题的 AI 驱动解释
  • 管理依赖和项目配置

示例用法： ​

"为我的项目运行 Maven 测试"
"将 Spring Boot starter 依赖添加到我的 pom.xml"

调试问题 ​

当您遇到问题时，Kiro 可以帮助诊断和修复：

调试方法 ​

  • 内联聊天：输入 Cmd/Ctrl + I 打开内联聊天

    • 要求 Kiro 解释特定错误或为当前代码建议修复方案

  • 添加到聊天：输入 Cmd/Ctrl + L 将当前文件添加到聊天

    • 要求 Kiro 分析整个文件的潜在问题或改进

  • 快速修复：悬停在错误或警告上，然后选择快速修复和询问 Kiro

    • Kiro 将自动将代码添加到聊天并开始调试

资源 ​

通过遵循本指南，您将能够充分利用 Kiro 的 AI 辅助功能来提高 Java 开发效率和代码质量。

基于 MIT 许可证发布

版权所有 © 2025-至今