Skip to content

Maven SDK GoA Go SDK for Maven operations

在 Go 里定位、驱动、解析、安装 Maven —— 一个包管一件事,可拼装、可测试、可重入。

Maven SDK Go
6
职责清晰的包
3
平台 · Linux / macOS / Windows
100%
纯 Go,零 cgo 依赖
MIT
开源协议
一行安装go get github.com/scagogogo/mvn-skills

为什么需要它 ​

在 Go 里集成 Maven,通常意味着反复 exec.Command("mvn", ...)、手拼参数、 事后 strings.Contains 找输出里的版本号。这套 SDK 把这些碎活收口成六个 职责清晰的包:一个包管一件事,彼此只在必要时触碰。

  • AI 智能体友好:每个包都是纯函数 / 进程内 / 显式 I/O,调用图清晰,便于智能体编排
  • 可测试:Builder 不可变,子进程执行有可注入的入口,mock server 覆盖下载链路
  • 可重入:安装幂等(已装且版本够新就跳过),构建参数可复现
  • 跨平台:Windows 的 setx PATH 截断、macOS 的 dyld、Linux 的包管理器差异都已被吸收

不写 SDK 时,你大概在做这些事 ​

场景裸 exec.CommandMaven SDK Go
找 Maven硬编码 "mvn",CI 上没装就崩finder.FindBestMaven 自动用 mvnw / PATH / M2_HOME
拼参数字符串拼接、-D 转义坑fluent Builder,不可变、可复用
取版本号strings.Contains 找输出command 解析 mvn -v 的结构化结果
装环境让用户先装好再来installer.Install() 下载 + SHA512 + 配 PATH
解析 pom拉 encoding/xml 手写结构体pom.ParseFile 给你强类型 GAV / 依赖 / 插件

架构总览 ​

端到端:find → build → resolve a JAR ​

一个典型会话贯穿三个包 —— finder 选一个 Maven,command 驱动构建, local_repository 把坐标变成磁盘上的文件:

六个包各管一摊,副作用层层向外(最右两列是 I/O 所在地):

我该用哪个包? ​

Quick Start ​

安装 ​

bash
go get github.com/scagogogo/mvn-skills

定位 Maven 并跑一次构建 ​

最常用的入口:定位一个可用的 Maven,然后用 command builder 驱动它。

go
package main

import (
    "fmt"
    "log"

    "github.com/scagogogo/mvn-skills/pkg/command"
    "github.com/scagogogo/mvn-skills/pkg/finder"
)

func main() {
    // 优先项目的 ./mvnw,回退到系统 Maven。
    mvn, err := finder.FindBestMaven(".")
    if err != nil {
        log.Fatal(err)
    }

    // mvn -B -DskipTests clean install
    output, err := command.NewCommandBuilder().
        WithExecutable(mvn).
        WithBatchMode().
        WithSkipTests().
        CleanInstall()
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(output)
}

在本地仓库里定位一个 JAR ​

FindJar 在 local_repository 包里,第一个参数是仓库目录(用 finder + command 解析一次即可)。

go
mvn, _ := finder.FindMaven()
repoDir := local_repository.ParseLocalRepositoryDirectory(mvn) // ~/.m2/repository
jarPath, err := local_repository.FindJar(repoDir, "org.example", "example-artifact", "1.0.0")
if err != nil {
    log.Fatal(err)
}
fmt.Printf("Found JAR: %s\n", jarPath)

TIP

机器上没有 Maven?installer.Install() 会替你下载安装,返回 MAVEN_HOME。详见 Installer 参考。

CLI Usage ​

如果你不想写 Go 代码,也可以直接用 CLI。安装后执行:

bash
# 安装 CLI
go install github.com/scagogogo/mvn-skills/cmd/mvn-skills@latest

# 常用命令
mvn-skills find                  # 定位系统 Maven
mvn-skills version               # 查看版本信息
mvn-skills build                 # clean install
mvn-skills pom parse pom.xml     # 解析 pom.xml
mvn-skills --help                # 完整命令列表

完整 CLI 用法见 CLI Reference。

文档 ​

项目状态 ​

徽章说明
Go Report Card代码质量
GoDocAPI 文档
LicenseMIT 许可证

License ​

Released under the MIT License.

Released under the MIT License.