578 字

3 分钟

Igo - Cross-Platform Go Build Tool

2025-09-08

golang

go

/

golang

/

build-tool

/

cross-platform

/

cli

🚀 Igo - Cross-Platform Go Build Tool#

Igo 是一个强大的 跨平台 Go 构建与打包命令行工具，在 Go 原生 go build 的基础上，提供了更高级的能力：

一次配置，多平台打包
自动生成 zip、tar、tar.gz 等分发包
进度可视化
灵活的 YAML 配置

非常适合需要 跨平台交付二进制 的 Go 项目。

✨ 特性#

跨平台支持：Windows、macOS、Linux 一键构建
灵活配置：基于 YAML，支持变量替换
多种打包格式：ZIP、TAR、TAR.GZ
Go 原生命令扩展：集成 run、build 等命令
可定制：自定义变量、编译规则
进度可视化：长任务不再枯燥

⚡ 安装#

前置条件#

Go 1.21+
Git

从源码安装#

1
git clone https://github.com/qwqxl/igo.git
2
cd igo
3
go build -o igo main.go
4
# 全局安装（可选）
5
go install

直接安装#

1
go install github.com/qwqxl/igo@latest

🚀 快速开始#

1. 初始化项目配置#

1
igo init
2
# 或自定义配置文件名
3
igo init my-config

会生成一个 igo.yaml 配置文件。

2. 编辑配置#

1
project:
2
  name: "my-app"
3
  version: "1.0.0"
4
  main: "main.go"
5

6
build:
7
  platforms:
8
    - "windows/amd64"
9
    - "darwin/amd64"
10
    - "linux/amd64"

3. 构建项目#

1
igo build                   # 所有平台
2
igo build --platforms "windows/amd64,linux/amd64"
3
igo build --output ./bin

4. 打包分发#

1
igo package                 # 默认打包
2
igo package --format tar.gz # 指定格式
3
igo package --include "docs/,config/"

⚙️ 配置说明#

项目信息#

1
project:
2
  name: "your-app-name"
3
  version: "1.0.0"
4
  description: "Your app description"
5
  main: "main.go"
6
  output: "app-name"

构建配置#

1
build:
2
  platforms:
3
    - "windows/amd64"
4
    - "darwin/amd64"
5
    - "linux/amd64"
6
  tags: ["release"]
7
  flags: ["-ldflags=-s -w"]
8
  env:
9
    CGO_ENABLED: "0"
10
  output_dir: "dist"
11
  type: "binary"

打包配置#

1
package:
2
  include:
3
    - "README.md"
4
    - "LICENSE"
5
  exclude:
6
    - ".git"
7
    - "*.tmp"
8
  format: "zip"
9
  output_dir: "packages"
10
  compression_level: 6

环境变量#

1
environment:
2
  APP_ENV: "production"
3
  DEBUG: "false"

自定义配置#

1
custom:
2
  company_name: "Your Company"
3
  config_name: "igo"

📦 命令列表#

igo init [config-name] → 初始化配置文件
igo run [args...] → 运行 Go 程序
igo build → 构建多平台二进制
igo package → 打包分发
igo validate → 校验配置
igo config → 查看当前配置

🖥 支持平台#

Windows: amd64, 386, arm64
macOS: amd64, arm64
Linux: amd64, 386, arm, arm64
FreeBSD: amd64, 386, arm, arm64

📂 支持的打包格式#

ZIP
TAR
TAR.GZ

🔧 变量替换#

配置文件中可以用 ${} 进行替换：

1
custom:
2
  company: "Acme"
3
  version: "1.0.0"
4

5
build:
6
  output_dir: "dist/${custom_company}-${custom_version}"

可用变量：

${project_name}
${project_version}
${env_KEY}
${custom_key}

📚 示例#

Web 应用#

1
package:
2
  include:
3
    - "static/"
4
    - "templates/"
5
    - "config.yaml"
6
  exclude:
7
    - "*.log"
8
    - ".env"

CLI 工具#

1
package:
2
  include:
3
    - "README.md"
4
    - "docs/"
5
    - "examples/"
6
  format: "tar.gz"

🛠 开发#

1
git clone https://github.com/qwqxl/igo.git
2
cd igo
3
go build -o igo main.go
4
go test ./...

📌 Roadmap#

📄 License#

MIT License → LICENSE

🔗 支持与反馈#

Igo - Cross-Platform Go Build Tool

https://iqwq.com/posts/golang/igo/

作者

Xiaolin

发布于

2025-09-08

许可协议

CC BY-NC-SA 4.0

Go动态代理

什么是杀青梗？

1

🚀 Igo - Cross-Platform Go Build Tool