golang开发框架 AI 工具生态配置指南

Oasis
发布于 14小时前
阅读 31

最近在学习golang微服务开发，接触了几个框架，这里找了一个相对初学者友好的框架go-zero来配置ai工具，按照目前的发展趋势，估计下一步很多主流开发语言的框架都会加入ai开发功能，如mcp配置等，让框架可以更好理解来自开发者的需求，输出更准确的逻辑和说明文档Go-Zero AI工具生态配置指南

> 最近在学习golang微服务开发，接触了几个框架，这里找了一个相对初学者友好的框架go-zero来配置，按照目前的发展趋势，估计下一步很多主流开发语言的框架都会加入ai开发功能，如mcp配置等，让框架可以更好理解来自开发者的需求，输出更准确的逻辑和说明文档

# Go-Zero AI 工具生态配置指南

> 基于 Windows 11 64位系统 + Go 1.24.8 版本

## 概述

该工具是 go-zero 团队构建的一套完整的 AI 工具生态，让 Claude、Trae、GitHub Copilot、Cursor、Windsurf 等 AI 编程助手成为你的开发专家。

### 三大核心组件

| 组件            | 定位               | 作用               |
| --------------- | ------------------ | ------------------ |
| **ai-context**  | 工作手册（~5KB）   | 告诉 AI "做什么"   |
| **zero-skills** | 技术百科（~40KB+） | 告诉 AI "怎么做好" |
| **mcp-zero**    | 实时助手           | 让 AI "真正动手做" |

### 协同工作原理

```
┌────────────────────────────────────┐
│ AI 编程助手 (Claude/Copilot/Cursor) │
└────────────┬───────────────────────┘
             │
    ┌────────┴─────────┐
    │                  │
    ▼                  ▼
┌──────────┐      ┌──────────┐
│ai-context│      │ mcp-zero │
│          │      │          │
│ 工作指令  │      │ 工具调用  │
│ 快速参考  │      │ 代码生成  │
└────┬─────┘      └────┬─────┘
     │                 │
     │    ┌────────────┘
     │    │
     ▼    ▼
┌──────────────┐
│ zero-skills  │
│              │
│ 详细模式      │
│ 完整示例      │
│ 故障排查      │
└──────────────┘
```

---

## 本机环境

- **操作系统**: Windows 11 64位
- **Go 版本**: 1.24.8 
- **Git**: 已安装并配置
- **goctl**: 1.92 go-zero 代码生成工具

### 检查环境

```powershell
# 检查 Go 版本
go version
# 输出: go version go1.24.8 windows/amd64

# 检查 Git
git --version

# 检查 goctl（如未安装，见下方安装步骤）
goctl --version
# 输出: goctl version 1.9.2 windows/amd64
```

### 安装 goctl（如未安装）

```powershell
go install github.com/zeromicro/go-zero/tools/goctl@latest
```

---

## 第一步：创建项目目录

```powershell
# 创建项目目录
mkdir C:\Users\tang\Desktop\goweb3
cd C:\Users\tang\Desktop\goweb3

# 初始化 Git 仓库
git init
```

---

## 第二步：配置 ai-context（AI 工作手册）

ai-context 是轻量级的指令层，告诉 AI 编程助手应该"做什么"。

### 添加为 Git Submodule

```powershell
cd C:\Users\zhang\Desktop\goweb3

# 添加 ai-context 作为 submodule
# Windsurf 用户放在 .windsurfrules 目录
git submodule add https://github.com/zeromicro/ai-context.git .windsurfrules
```

### 不同 IDE 的配置位置

| IDE                | 目录名                                              |
| ------------------ | --------------------------------------------------- |
| **Windsurf**       | `.windsurfrules/`                                   |
| **Cursor**         | `.cursorrules/`                                     |
| **GitHub Copilot** | `.github/copilot-instructions.md`（需创建符号链接） |

### 验证安装

- 本机使用了windsuf

```powershell
dir .windsurfrules
```

能看到以下文件：

- `00-instructions.md` - 主指令文件
- `patterns.md` - 代码模式
- `tools.md` - MCP 工具说明
- `workflows.md` - 工作流程

---

## 第三步：配置 zero-skills（AI 技术百科）

zero-skills 是详细的知识库，包含完整的实现模式和最佳实践。

### 添加为 Git Submodule

```powershell
cd C:\Users\tang\Desktop\goweb3

# 添加 zero-skills 作为 submodule
git submodule add https://github.com/zeromicro/zero-skills.git .zero-skills
```

### 验证安装

```powershell
dir .zero-skills
```

看到以下目录结构：

- `patterns/` - 详细模式（REST API、RPC、数据库等）
- `best-practices/` - 最佳实践
- `troubleshooting/` - 故障排查
- `getting-started/` - 快速开始

---

## 第四步：安装 mcp-zero（AI 实时助手）

mcp-zero 是 MCP 工具服务器，让 AI 能够调用 goctl 生成代码。

### 4.1 克隆仓库

```powershell
# 在临时目录克隆（不放在项目内，因为是全局工具）
cd C:\Users\tang\Desktop
git clone https://github.com/zeromicro/mcp-zero.git
cd mcp-zero
```

### 4.2 编译

```powershell
# 编译为 Windows 可执行文件
go build -o mcp-zero.exe main.go
```

### 4.3 全局安装

将编译好的可执行文件复制到 Go 的 bin 目录（与 goctl 同级）：

```powershell
# 查看 GOPATH
go env GOPATH
# 输出: E:\data\golang

# 复制到 Go bin 目录
copy mcp-zero.exe E:\data\golang\bin\mcp-zero.exe
```

### 4.4 验证安装

```powershell
# 验证 mcp-zero 可执行
E:\data\golang\bin\mcp-zero.exe --help
# 输出: Usage of E:\data\golang\bin\mcp-zero.exe:
#         -version
#               Print version information
```

### 4.5 清理临时文件（可选）

```powershell
# 删除临时克隆目录
Remove-Item -Recurse -Force C:\Users\tang\Desktop\mcp-zero
```

---

## 第五步：提交 Git 更改

```powershell
cd C:\Users\tang\Desktop\goweb3

# 添加 submodules 到 Git
git add .gitmodules .windsurfrules .zero-skills

# 提交
git commit -m "Add go-zero AI ecosystem: ai-context and zero-skills"
```

---

## 第六步：配置 MCP 客户端（可选）

如果你使用 Claude Desktop，需要配置 MCP 服务器。

### 编辑配置文件

打开 `%APPDATA%\Claude\claude_desktop_config.json`，添加：

```json
{
  "mcpServers": {
    "mcp-zero": {
      "command": "E:\\data\\golang\\bin\\mcp-zero.exe",
      "env": {
        "GOCTL_PATH": "E:\\data\\golang\\bin\\goctl.exe"
      }
    }
  }
}
```

### 重启 Claude Desktop

配置完成后重启 Claude Desktop 即可使用 mcp-zero 工具。

---

## 更新 Submodules

当官方更新了 ai-context 或 zero-skills 时，运行以下命令更新：

```powershell
cd C:\Users\tang\Desktop\goweb3

# 更新 ai-context
git submodule update --remote .windsurfrules

# 更新 zero-skills
git submodule update --remote .zero-skills

# 提交更新
git add .windsurfrules .zero-skills
git commit -m "Update go-zero AI ecosystem submodules"
```

---

## 最终目录结构

```
\Desktop\goweb3\
├── .git/
├── .gitmodules                 # Git submodule 配置
├── .windsurfrules/             # ai-context (Windsurf 规则)
│   ├── 00-instructions.md
│   ├── patterns.md
│   ├── tools.md
│   └── workflows.md
├── .zero-skills/               # zero-skills (知识库)
│   ├── patterns/
│   ├── best-practices/
│   ├── troubleshooting/
│   └── getting-started/
└── docs/
    └── go-zero-ai-ecosystem-setup.md  # 本文档

全局工具:
\data\golang\bin\
├── goctl.exe                   # go-zero 代码生成工具
└── mcp-zero.exe                # MCP 工具服务器
```

---

## 使用示例

配置完成后，AI 编程助手会自动读取 `.windsurfrules` 中的规则，按照 go-zero 规范生成代码。

### 示例对话

**你**: 创建一个简单的用户服务 REST API

**AI 助手 按照 go-zero 工作流，先创建 API 规范文件，然后用 goctl 生成代码。**:

1. 读取 `ai-context` → 了解应该用 `create_api_service` 工具
2. 调用 `mcp-zero` → 执行代码生成
3. 参考 `zero-skills` → 获取 Handler/Logic/Context 三层架构的完整模式
4. 生成符合 go-zero 规范的完整实现

#### 生成好的目录结构如下：

```
hello/
├── etc/
│   └── hello-api.yaml      # 配置文件
├── internal/
│   ├── config/             # 配置结构
│   ├── handler/            # HTTP 处理器
│   ├── logic/              # 业务逻辑 ← 你的代码写这里
│   ├── svc/                # 服务上下文
│   └── types/              # 请求/响应类型
├── hello.api               # API 规范文件
├── hello.go                # 入口文件
└── go.mod
```

## 测试结果

| 请求                            | 响应                            |
| :------------------------------ | :------------------------------ |
| `GET /api/v1/hello`             | `{"message": "Hello, World!"}`  |
| `GET /api/v1/hello?name=golang` | `{"message": "Hello, golang!"}` |

### 最终效果如图：

![demo1.jpg](https://img.learnblockchain.cn/attachments/2025/12/j0F3x9Wg693706e255992.jpg)

---

## 相关链接

- **go-zero 框架**: https://github.com/zeromicro/go-zero
- **ai-context**: https://github.com/zeromicro/ai-context
- **zero-skills**: https://github.com/zeromicro/zero-skills
- **mcp-zero**: https://github.com/zeromicro/mcp-zero
- **go-zero 官方文档**: https://go-zero.dev

---

## 版本信息

| 组件        | 版本    | 安装日期   |
| ----------- | ------- | ---------- |
| Windows     | 11 64位 | -          |
| Go          | 1.24.8  | -          |
| goctl       | 1.9.2   | -          |
| ai-context  | latest  | 2025-12-09 |
| zero-skills | latest  | 2025-12-09 |
| mcp-zero    | latest  | 2025-12-09 |

最近在学习golang微服务开发，接触了几个框架，这里找了一个相对初学者友好的框架go-zero来配置，按照目前的发展趋势，估计下一步很多主流开发语言的框架都会加入ai开发功能，如mcp配置等，让框架可以更好理解来自开发者的需求，输出更准确的逻辑和说明文档

Go-Zero AI 工具生态配置指南

基于 Windows 11 64位系统 + Go 1.24.8 版本

概述

该工具是 go-zero 团队构建的一套完整的 AI 工具生态，让 Claude、Trae、GitHub Copilot、Cursor、Windsurf 等 AI 编程助手成为你的开发专家。

三大核心组件

组件	定位	作用
ai-context	工作手册（~5KB）	告诉 AI "做什么"
zero-skills	技术百科（~40KB+）	告诉 AI "怎么做好"
mcp-zero	实时助手	让 AI "真正动手做"

协同工作原理

┌────────────────────────────────────┐
│ AI 编程助手 (Claude/Copilot/Cursor) │
└────────────┬───────────────────────┘
             │
    ┌────────┴─────────┐
    │                  │
    ▼                  ▼
┌──────────┐      ┌──────────┐
│ai-context│      │ mcp-zero │
│          │      │          │
│ 工作指令  │      │ 工具调用  │
│ 快速参考  │      │ 代码生成  │
└────┬─────┘      └────┬─────┘
     │                 │
     │    ┌────────────┘
     │    │
     ▼    ▼
┌──────────────┐
│ zero-skills  │
│              │
│ 详细模式      │
│ 完整示例      │
│ 故障排查      │
└──────────────┘

本机环境

操作系统: Windows 11 64位
Go 版本: 1.24.8
Git: 已安装并配置
goctl: 1.92 go-zero 代码生成工具

检查环境

# 检查 Go 版本
go version
# 输出: go version go1.24.8 windows/amd64

# 检查 Git
git --version

# 检查 goctl（如未安装，见下方安装步骤）
goctl --version
# 输出: goctl version 1.9.2 windows/amd64

安装 goctl（如未安装）

go install github.com/zeromicro/go-zero/tools/goctl@latest

第一步：创建项目目录

# 创建项目目录
mkdir C:\Users\tang\Desktop\goweb3
cd C:\Users\tang\Desktop\goweb3

# 初始化 Git 仓库
git init

第二步：配置 ai-context（AI 工作手册）

ai-context 是轻量级的指令层，告诉 AI 编程助手应该"做什么"。

添加为 Git Submodule

cd C:\Users\zhang\Desktop\goweb3

# 添加 ai-context 作为 submodule
# Windsurf 用户放在 .windsurfrules 目录
git submodule add https://github.com/zeromicro/ai-context.git .windsurfrules

不同 IDE 的配置位置

IDE	目录名
Windsurf	`.windsurfrules/`
Cursor	`.cursorrules/`
GitHub Copilot	`.github/copilot-instructions.md`（需创建符号链接）

验证安装

本机使用了windsuf

dir .windsurfrules

能看到以下文件：

00-instructions.md - 主指令文件
patterns.md - 代码模式
tools.md - MCP 工具说明
workflows.md - 工作流程

第三步：配置 zero-skills（AI 技术百科）

zero-skills 是详细的知识库，包含完整的实现模式和最佳实践。

添加为 Git Submodule

cd C:\Users\tang\Desktop\goweb3

# 添加 zero-skills 作为 submodule
git submodule add https://github.com/zeromicro/zero-skills.git .zero-skills

验证安装

dir .zero-skills

看到以下目录结构：

patterns/ - 详细模式（REST API、RPC、数据库等）
best-practices/ - 最佳实践
troubleshooting/ - 故障排查
getting-started/ - 快速开始

第四步：安装 mcp-zero（AI 实时助手）

mcp-zero 是 MCP 工具服务器，让 AI 能够调用 goctl 生成代码。

4.1 克隆仓库

# 在临时目录克隆（不放在项目内，因为是全局工具）
cd C:\Users\tang\Desktop
git clone https://github.com/zeromicro/mcp-zero.git
cd mcp-zero

4.2 编译

# 编译为 Windows 可执行文件
go build -o mcp-zero.exe main.go

4.3 全局安装

将编译好的可执行文件复制到 Go 的 bin 目录（与 goctl 同级）：

# 查看 GOPATH
go env GOPATH
# 输出: E:\data\golang

# 复制到 Go bin 目录
copy mcp-zero.exe E:\data\golang\bin\mcp-zero.exe

4.4 验证安装

# 验证 mcp-zero 可执行
E:\data\golang\bin\mcp-zero.exe --help
# 输出: Usage of E:\data\golang\bin\mcp-zero.exe:
#         -version
#               Print version information

4.5 清理临时文件（可选）

# 删除临时克隆目录
Remove-Item -Recurse -Force C:\Users\tang\Desktop\mcp-zero

第五步：提交 Git 更改

cd C:\Users\tang\Desktop\goweb3

# 添加 submodules 到 Git
git add .gitmodules .windsurfrules .zero-skills

# 提交
git commit -m "Add go-zero AI ecosystem: ai-context and zero-skills"

第六步：配置 MCP 客户端（可选）

如果你使用 Claude Desktop，需要配置 MCP 服务器。

编辑配置文件

打开 %APPDATA%\Claude\claude_desktop_config.json，添加：

{
  "mcpServers": {
    "mcp-zero": {
      "command": "E:\\data\\golang\\bin\\mcp-zero.exe",
      "env": {
        "GOCTL_PATH": "E:\\data\\golang\\bin\\goctl.exe"
      }
    }
  }
}

重启 Claude Desktop

配置完成后重启 Claude Desktop 即可使用 mcp-zero 工具。

更新 Submodules

当官方更新了 ai-context 或 zero-skills 时，运行以下命令更新：

cd C:\Users\tang\Desktop\goweb3

# 更新 ai-context
git submodule update --remote .windsurfrules

# 更新 zero-skills
git submodule update --remote .zero-skills

# 提交更新
git add .windsurfrules .zero-skills
git commit -m "Update go-zero AI ecosystem submodules"

最终目录结构

\Desktop\goweb3\
├── .git/
├── .gitmodules                 # Git submodule 配置
├── .windsurfrules/             # ai-context (Windsurf 规则)
│   ├── 00-instructions.md
│   ├── patterns.md
│   ├── tools.md
│   └── workflows.md
├── .zero-skills/               # zero-skills (知识库)
│   ├── patterns/
│   ├── best-practices/
│   ├── troubleshooting/
│   └── getting-started/
└── docs/
    └── go-zero-ai-ecosystem-setup.md  # 本文档

全局工具:
\data\golang\bin\
├── goctl.exe                   # go-zero 代码生成工具
└── mcp-zero.exe                # MCP 工具服务器

使用示例

配置完成后，AI 编程助手会自动读取 .windsurfrules 中的规则，按照 go-zero 规范生成代码。

示例对话

你: 创建一个简单的用户服务 REST API

AI 助手按照 go-zero 工作流，先创建 API 规范文件，然后用 goctl 生成代码。:

读取 ai-context → 了解应该用 create_api_service 工具
调用 mcp-zero → 执行代码生成
参考 zero-skills → 获取 Handler/Logic/Context 三层架构的完整模式
生成符合 go-zero 规范的完整实现

生成好的目录结构如下：

hello/
├── etc/
│   └── hello-api.yaml      # 配置文件
├── internal/
│   ├── config/             # 配置结构
│   ├── handler/            # HTTP 处理器
│   ├── logic/              # 业务逻辑 ← 你的代码写这里
│   ├── svc/                # 服务上下文
│   └── types/              # 请求/响应类型
├── hello.api               # API 规范文件
├── hello.go                # 入口文件
└── go.mod

测试结果

请求	响应
`GET /api/v1/hello`	`{"message": "Hello, World!"}`
`GET /api/v1/hello?name=golang`	`{"message": "Hello, golang!"}`

最终效果如图：

版本信息

组件	版本	安装日期
Windows	11 64位	-
Go	1.24.8	-
goctl	1.9.2	-
ai-context	latest	2025-12-09
zero-skills	latest	2025-12-09
mcp-zero	latest	2025-12-09

原创
学分: 0
分类: Go
标签:

本文参与登链社区写作激励计划，好文好收益，欢迎正在阅读的你也加入。

golang开发框架 AI 工具生态配置指南

Go-Zero AI 工具生态配置指南

概述

三大核心组件

协同工作原理

本机环境

检查环境

安装 goctl（如未安装）

第一步：创建项目目录

第二步：配置 ai-context（AI 工作手册）

添加为 Git Submodule

不同 IDE 的配置位置

验证安装

第三步：配置 zero-skills（AI 技术百科）

添加为 Git Submodule

验证安装

第四步：安装 mcp-zero（AI 实时助手）

4.1 克隆仓库

4.2 编译

4.3 全局安装

4.4 验证安装

4.5 清理临时文件（可选）

第五步：提交 Git 更改

第六步：配置 MCP 客户端（可选）

编辑配置文件

重启 Claude Desktop

更新 Submodules

最终目录结构

使用示例

示例对话

生成好的目录结构如下：

测试结果

最终效果如图：

相关链接

版本信息

0 条评论

文章目录