在 Windows 系统上配置 [go-zero](https://go-zero.dev) 开发环境教程
💻 在 Windows 系统上配置 go-zero 开发环境教程
本教程将详细介绍如何在 Windows 系统上配置 go-zero 微服务框架的开发环境，包括依赖安装、路径配置、常见问题等。
🧱 一、前置环境安装
1. 安装 Go
- 下载地址：https://go.dev/dl/
- 安装时可自定义路径（如：
D:\Go） - 安装完成后，验证是否成功：
go version
输出示例：
go version go1.21.3 windows/amd64
✅ 建议使用 Go 1.18 及以上版本
2. 安装 Git
- 下载地址：https://git-scm.com/downloads
- 安装位置可自定义
- 安装后验证：
git --version
3. 安装 Protocol Buffers（protoc）
go-zero 使用 Protobuf 定义 RPC 服务，需安装 protoc 编译器：
推荐方式：下载预编译版本
- 下载地址：https://github.com/protocolbuffers/protobuf/releases
- 选择适合的版本，如：
protoc-21.12-win64.zip - 解压后，将
bin目录加入系统环境变量PATH
验证安装：
protoc --version
⚙️ 二、配置开发环境（迁移到 D 盘，避免占用 C 盘）
默认情况下，Go 会将依赖和工具安装到 C:\Users\<用户名>\go。我们建议将其迁移到 D 盘，提升可维护性和节省空间。
1. 配置环境变量（系统设置）
建议将 Go 安装到 D 盘，并设置如下变量：
| 变量名 | 示例路径 |
|---|---|
| GOROOT | D:\Go |
| GOPATH | D:\GoWorkspace |
| GOBIN | D:\GoWorkspace\bin |
然后将以下路径加入系统环境变量 PATH：
D:\Go\bin
D:\GoWorkspace\bin
2. 手动创建工作目录结构
在 D 盘创建以下目录（如不存在）：
D:\GoWorkspace\src
D:\GoWorkspace\bin
D:\GoWorkspace\pkg
3. 配置 Go 环境参数
在终端中执行以下命令：
go env -w GOROOT=D:\Go
go env -w GOPATH=D:\GoWorkspace
go env -w GOBIN=D:\GoWorkspace\bin
go env -w GOPROXY=https://goproxy.cn,direct
查看当前配置：
go env
输出示例：
GOROOT="D:\Go"
GOPATH="D:\GoWorkspace"
GOBIN="D:\GoWorkspace\bin"
📦 三、安装 go-zero 与 goctl 工具
1. 初始化项目并自动拉取 go-zero
go mod init your_project
go get github.com/zeromicro/go-zero
2. 安装 goctl（go-zero 的代码生成工具）
推荐使用 go install 方式（Go 1.17+ 必须指定版本）：
go install github.com/zeromicro/go-zero/tools/goctl@latest
确保 $GOBIN（如：D:\GoWorkspace\bin）已加入环境变量 PATH，然后验证安装：
goctl --version
🚀 四、快速创建 go-zero 项目
创建 REST 项目
goctl api new demo
cd demo
go mod tidy
go run demo.go
生成结构：
.
├── demo.api
├── etc
│ └── demo.yaml
├── internal
│ ├── config
│ ├── handler
│ ├── logic
│ ├── svc
│ └── types
└── demo.go
创建 RPC 项目
goctl rpc new greet
cd greet
go mod tidy
🧩 五、常见问题排查
| 问题 | 解决方案说明 |
|---|---|
goctl 命令找不到 | 检查 $GOBIN 是否已加入系统环境变量 PATH |
protoc 报错或未识别 | 检查是否正确安装并将 protoc.exe 所在的 bin 路径加入了 PATH 环境变量 |
| 中文或空格路径导致构建失败 | 避免在项目路径中使用中文、空格或特殊字符 |
| 推荐 IDE | 推荐使用 GoLand 或 VSCode + Go 插件 |
🛠 六、附加技巧与推荐配置
1. goctl 插件模板升级与环境检查
goctl upgrade -u
goctl env check
2. 使用 goctl 生成 handler 和 logic
goctl api go -api demo.api -dir .
会自动生成路由、业务逻辑和服务定义，极大提升开发效率。
✅ 项目目录建议
推荐将项目统一放在：
D:\GoWorkspace\src\
或者使用 Go Modules，可将项目放在任意路径下（如 D:\Projects\xxx），示例：
mkdir D:\Projects\demo
cd D:\Projects\demo
go mod init demo