环境准备

面向不熟悉 Go 的开发者。先配好 Go 工具链，再配代理与工作区，最后准备 MySQL / Redis。

1. 安装 Go

下载并安装 Go 1.26 及以上（go.mod 锁定 go 1.26.5）：

• 官方下载：https://go.dev/dl/
• 国内镜像：https://golang.google.cn/dl/

Windows 用 msi 安装包，安装时勾选自动配置环境变量；macOS/Linux 用 tar -C /usr/local -xzf 解压后手动加 PATH。安装完成后验证：

go version      # 应输出 go1.26.x
go env GOROOT   # Go 安装根目录

2. 配置环境变量

Go 用环境变量控制工具链行为，关键字段如下：

变量	作用	建议值
GOROOT	Go 安装目录（含编译器、标准库）	安装器默认值，一般不用手改
GOPATH	工作区：go install 装的 bin、缓存的模块	默认 ~/go，不要和项目目录混在一起
GOPROXY	模块下载代理	https://goproxy.cn,direct（国内）
GOSUMDB	校验和数据库	sum.golang.google.cn（国内对齐上）
GO111MODULE	模块模式开关	on（1.16+ 默认即 on）
GOBIN	go install 产物目录	默认 $GOPATH/bin
GOOS/GOARCH	交叉编译目标	本机编译不用设

Windows PowerShell（仅当前会话）：

$env:GOPROXY = "https://goproxy.cn,direct"
$env:GO111MODULE = "on"

Windows PowerShell（持久，写进用户环境变量，重开终端生效）：

[Environment]::SetEnvironmentVariable("GOPROXY", "https://goproxy.cn,direct", "User")
[Environment]::SetEnvironmentVariable("GO111MODULE", "on", "User")

Linux / macOS：

go env -w GOPROXY=https://goproxy.cn,direct
go env -w GO111MODULE=on
go env -w GOSUMDB=sum.golang.google.cn

go env -w 写进 ~/.config/go/env，对所有项目生效，推荐用这种方式而非改系统环境变量。常用 GOPROXY 选项：

• https://goproxy.cn,direct —— 七牛云，国内最稳，优先用这个。
• https://goproxy.io,direct —— 备选。
• https://proxy.golang.org,direct —— 官方代理，国内访问慢。 末尾 ,direct 表示代理拿不到时直连源站（如 GitHub）。

把 $GOPATH/bin（默认 ~/go/bin）加进 PATH，这样 go install 装的工具能直接用：

# Windows
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$env:USERPROFILE\go\bin", "User")

# Linux / macOS（写进 ~/.bashrc 或 ~/.zshrc）
export PATH="$PATH:$(go env GOPATH)/bin"

3. IDE / 编辑器

推荐 Visual Studio Code + Go 扩展，或 GoLand（JetBrains）。VS Code 首次打开 .go 文件会提示安装 gopls 等辅助工具，全部勾选安装即可。

4. 数据库与依赖准备

1. MySQL 8.x，字符集 utf8mb4，时区配置正确（容器化部署依赖 tzdata，见 Docker 部署）。

2. Redis 6.x 及以上。

3. 初始化数据库：执行 script/sql/ry_vue.sql（建表 SQL 直接复用原 Java 项目，表结构一致）。

4. 改连接配置：修改 configs/application.yaml 里的 datasource、redis 为本机配置。详见 配置说明。

5. sa-token-go 依赖：以本地检出路径 replace（见 go.mod 末尾）：

   github.com/sa-tokens/sa-token-go/core             => E:/WorkSpace/sa-token-go-main/core
   github.com/sa-tokens/sa-token-go/integrations/gin => E:/WorkSpace/sa-token-go-main/integrations/gin
   ...

   本机若可直连 goproxy，删掉该 replace 块并 go get 即可；否则需先在 E:/WorkSpace/sa-token-go-main 检出 sa-token-go 源码。

完成上述步骤后执行依赖整理：

go mod tidy
go build ./...     # 全量编译，提交前必过
go vet ./...       # 静态检查，提交前必过

5. 验证

go env              # 查看所有 Go 环境变量，确认 GOPROXY / GOPATH 生效
go version          # go1.26.x

环境就绪后，前往 本地运行 启动项目。