JetBrains Amper 0.10 发布：这 9 个变化最值得开发者关注

DevLlama

发布于 2026-06-24 21:04:17

880

如果你最近在看 JetBrains 的 Amper，可能会有一个很直接的问题：

这个还处在 experimental 阶段的构建工具，这次 0.10 到底更新了什么？

JetBrains 在官方博客中发布了 Amper 0.10.0。原文给出的关键词很明确：JDK provisioning、Maven-to-Amper converter、custom Kotlin compiler plugins，以及一批 IDE 体验改进。

这篇文章不扩展背景，不做额外推测，只根据 JetBrains 这篇官方文章，把 Amper 0.10.0 的重点整理成一份清单。

如果你只是想快速判断“这次值不值得看”，按下面 9 点读就够了。

1. 先确认版本要求：IDE 和插件要跟上

Amper 0.10.0 不是只更新命令行工具就结束。

JetBrains 在原文中明确提到：如果要获得 Amper 最新功能支持，需要使用 IntelliJ IDEA 2025.3.4、IntelliJ IDEA 2026.1，或更新版本。

同时，还要确保安装了最新版 Amper plugin。

所以第一步不是改配置，也不是迁移项目，而是先检查环境：

• IntelliJ IDEA 是否达到 2025.3.4 或 2026.1 以上；
• Amper plugin 是否已经是最新版本；
• 当前项目是否准备用 Amper 0.10.0 的新能力。

先把工具链对齐，后面的体验才会成立。

2. JDK provisioning：项目可以声明自己需要什么 JDK

Amper 需要 JDK 来完成很多任务。

比如编译 Kotlin 和 Java 源码、运行测试、运行 JVM 应用等。

JetBrains 在文章里提到 Amper 的一个理念：你应该可以在不手动安装、不手动配置任何东西的情况下运行项目。

因此，Amper 可以自动为你 provision 一个 JDK。默认是 JDK 21。

但现实情况是，有些项目确实需要特定版本的 JDK。Amper 0.10.0 开始，可以在 module.yaml 里指定所需 JDK 的条件，Amper 会下载并安装匹配的 JDK。

示例配置如下：

settings:
  jvm:
    jdk:
      version: # major version
      distributions: [ zulu, temurin ] # acceptable distributions

这里有两个信息值得注意：

• 可以指定 JDK major version；
• 可以指定可接受的 distributions，例如 zulu、temurin。

原文还提到，Amper 也会考虑 JAVA_HOME 环境变量，因为这是机器上设置 JDK 的常见方式。

换句话说，Amper 0.10.0 在 JDK 这件事上更进一步：既保留自动准备能力，也允许项目明确表达自己的 JDK 要求。

3. Maven converter：迁移时不用从零重写配置

如果你已经有一个 Maven 项目，Amper 0.10.0 给了一个半自动转换工具。

它会读取 pom.xml 文件，包括 multi-module reactor projects 中的 POM，然后生成对应的 project.yaml 和 module.yaml 文件。

使用方式是：

./amper tool convert-project

按照原文描述，转换器会映射这些内容：

• dependencies；
• BOMs；
• repositories；
• publishing coordinates；
• compiler flags；
• other settings。

为了让项目在迁移期间可以同时使用两套构建系统，转换器会在每个 module 中设置：

layout: maven-like

这样一来，项目原有的源码目录结构可以保留，例如：

• src/main/java；
• src/main/kotlin。

也就是说，迁移时不需要先移动文件。

这点很关键。因为对已有项目来说，最怕的不是写一份新配置，而是一边改构建系统，一边还要调整目录结构。

Amper 0.10.0 的 Maven converter，目标就是把这一步变得更轻。

4. Maven plugin compatibility：常见插件会被翻译，其他插件进入新配置区

Amper 0.10.0 不只是读取 POM。

原文还提到，一些 well-known Maven plugins 会被转换为 Amper 内置设置。

其中包括：

• maven-compiler-plugin；
• spring-boot-maven-plugin。

其他 Maven plugins 会被添加到 module.yaml 中新的 mavenPlugins 配置区。Amper 可以通过 Maven plugin compatibility layer，在构建过程中执行它们。

不过，这里也要注意边界。

JetBrains 明确说转换是 best-effort，所以部分项目在转换后可能仍然需要调整。

因此，这个功能适合这样理解：

它不是承诺“所有 Maven 项目一键无痛迁移”，而是提供一个半自动起点，让你不用从空白文件开始。

迁移不是一步到位，而是先把 70% 的重复劳动交给工具。

5. Kotlin compiler plugins：开始支持第三方编译器插件

Amper 0.10.0 带来了 third-party Kotlin compiler plugins 支持。

启用方式是在 module.yaml 中添加配置：

settings:
  kotlin:
    compilerPlugins:
      - id: org.example.my.plugin
        dependency: org.example:my-plugin:1.0.0
        options:
          myKey1: myValue1
          myKey2: myValue2

从这个示例可以看到，一个插件配置至少涉及：

• id；
• dependency；
• options。

原文还提到，文档中提供了示例，并说明如何为 custom plugins 启用 IDE support。

除了第三方插件支持，这次还新增了两个内置支持：

• kotlinx.rpc compiler plugin；
• JsPlainObjects compiler plugin。

对 Kotlin 项目来说，这意味着 Amper 0.10.0 在编译器扩展场景上更开放了。

6. IDE 运行体验：Amper 命令配置界面被重做

Amper 0.10.0 也更新了 IDE 中运行命令的体验。

JetBrains 提到，他们重新设计了创建和编辑 run configurations 的 UI。

新的 custom views 可以让你更方便地配置 run 和 test commands 的选项。

此外，现在也可以在 Add New Configuration 菜单中选择 Amper，为任意 Amper command 创建配置。

如果只是临时运行一个命令，也可以使用 Run Anything，也就是 Ctrl+Ctrl，然后在命令前加上：

amper:

这类改动看起来不像底层功能那么“重”，但对日常开发体验很关键。

因为构建工具如果只在命令行里好用，在 IDE 里割裂，开发者还是会感觉别扭。

Amper 0.10.0 这次明显在补 IDE 侧的操作体验。

7. IDE 细节改进：native app、JUnit 5、Ktor、Profiler

除了运行配置 UI，原文还列出了一组 IDE 改进。

第一，native applications 可以通过 gutter 运行。

范围包括：

• linux/app；
• macos/app；
• windows/app。

第二，Test tool window 中的测试名称更友好。

Amper 0.10.0 会尊重 JUnit 5 的这些注解：

• @DisplayName；
• @ParameterizedTest.name。

原文示例是：

@ParameterizedTest(name = "Test #{0}")
@DisplayName("My parameterized test")
@ValueSource(ints = [1, 2, 3])
fun parameterized(i: Int) {}

第三，如果 module 有 Ktor server dependency，module.yaml 会提供 Add Plugins… inlay，支持搜索和添加插件。

也可以在 Kotlin code 中使用 completion，它会把必要依赖添加到 module 中，不需要你手动修改 module.yaml。

第四，JVM applications 支持 profiling。

但这里有一个限制：原文注明，这个功能需要 IntelliJ IDEA Ultimate。

所以这部分可以简单归纳为：

• native app 更容易从 IDE 启动；
• JUnit 5 测试显示更准确；
• Ktor 插件添加更方便；
• JVM app 可以借助 IntelliJ IDEA 的 profiler 支持运行。

8. Amper plugin development：插件可以引用 module settings

上一篇 Amper release 带来了 extensibility system preview。

在 0.10.0 中，JetBrains 表示他们收到了很多反馈，也正在扩展插件能力。

不过，发布和分享插件的能力仍然是 work in progress。

这次已经可用的一个改进是：插件可以在 plugin.yaml 中使用 ${module.settings} 引用 module settings。

这说明 Amper 的插件系统还在继续推进，但目前仍处在逐步完善阶段。

如果你关注 Amper 插件开发，这次可以重点看这个变化；如果只是使用 Amper 构建项目，这一条暂时可以先记为“生态能力继续推进”。

9. 其他更新：Maven profiles、module 描述、默认版本升级

Amper 0.10.0 还有一些分散但实用的改进。

首先，从 0.10 开始，Amper 支持 transitive dependencies 的 POM 文件中声明的 Maven profiles。

其次，module.yaml 可以添加 module descriptions。

这个 description 使用 Markdown 格式，可以写多行。它会被用于：

• CLI 中的 ./amper show modules 命令；
• IDE 中展示 module 信息；
• 对 library 来说，默认也会作为 published metadata 的描述。

最后，JetBrains 更新了一组 toolchains 和 frameworks 的默认版本：

• Kotlin：2.3.20；
• Android minimum SDK：23；
• Compose：1.10.3；
• KSP：2.3.6；
• Ktor：3.4.1；
• Spring Boot：4.0.5。

插图：Amper 0.10 更新清单

这里适合放一张 Spring Boot 4.0 相关插图，因为原文的默认版本清单中明确提到了 Spring Boot：4.0.5。

最后：如果你已经在用 Amper，升级命令很简单

如果你已经有一个 Amper 项目，原文给出的更新方式是：

./amper update

如果你还没开始使用 Amper，JetBrains 建议查看 Getting started guide、examples、tutorial，或者 comprehensive user guide。

同时，JetBrains 也再次强调：Amper 仍然是 experimental，并且正在 active development。

一张清单总结 Amper 0.10.0

如果只保留最关键的信息，可以记住这 9 点：

1. 使用最新功能，需要 IntelliJ IDEA 2025.3.4 / 2026.1 或更新版本，并安装最新版 Amper plugin。
2. Amper 可以自动 provision JDK，默认 JDK 21，也可以在 module.yaml 中声明版本和 distributions。
3. Maven converter 可以读取 POM，并生成 project.yaml 和 module.yaml。
4. 转换器会设置 layout: maven-like，迁移时不需要移动 src/main/java、src/main/kotlin 等目录。
5. 常见 Maven plugins 会被翻译成 Amper 内置设置，其他插件进入 mavenPlugins。
6. Amper 0.10.0 支持 third-party Kotlin compiler plugins，并新增 kotlinx.rpc、JsPlainObjects 内置支持。
7. IDE 中 Amper run configurations 的创建和编辑体验被重做，也支持通过 Run Anything 临时运行命令。
8. native app gutter、JUnit 5 测试名称、Ktor plugin assistance、JVM profiling 都有 IDE 侧增强。
9. 默认版本更新到 Kotlin 2.3.20、Android min SDK 23、Compose 1.10.3、KSP 2.3.6、Ktor 3.4.1、Spring Boot 4.0.5。