Go 1.22+ 环境变量配置只需确保 GOROOT 指向安装路径且 PATH 包含 $GOROOT/bin；GO111MODULE=on 已默认启用，无需设置 GOPATH，硬设反而引发模块识别错误。
Go 1.22+ 环境变量配置必须绕开 GOPATH 模式
Go 1.16 起已默认启用 GO111MODULE=on，1.18 后彻底弃用 GOPATH 作为项目根路径的强制约定。现在新建项目直接 go mod init example.com/myapp 即可，无需提前设置 GOPATH。硬设 GOPATH 反而会导致 go run 找不到模块、go get 报 cannot find module providing package 错误。
真正需要配的只有两个环境变量：
-
GOROOT：指向 Go 安装目录（如/usr/local/go或C:\Program Files\Go），通常安装器已自动写入，手动检查go env GOROOT即可确认 -
PATH：确保包含$GOROOT/bin，否则命令行打go会提示“command not found”
其他变量如 GOBIN、GOPROXY 属于可选优化项：GOPROXY=https://goproxy.cn 能解决国内 go mod download 卡住问题，但不是必填项。
VS Code + Go 扩展在 2026 年必须禁用旧版语言服务器
VS Code 的 Go 扩展（由 golang.org/x/tools 提供）从 v0.37 开始默认启用 gopls v0.14+，但老项目或缓存残留可能触发 gopls v0.10 甚至更早版本——它不支持泛型完整校验、无法识别 type alias、对 go.work 多模块 workspace 解析失败，表现为：保存后无报错但运行时报 undefined: xxx，或跳转定义失效。
立即学习“go语言免费学习笔记（深入）”；
实操建议：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 打开 VS Code 设置，搜索
go.gopls.path，清空该字段（让插件自动选择最新二进制） - 在项目根目录运行
go install golang.org/x/tools/gopls@latest，再重启 VS Code - 若仍异常，删掉
~/.gopls缓存目录（Linux/macOS）或%LOCALAPPDATA%\gopls（Windows）
Docker 中构建跨平台二进制要显式传 GOOS/GOARCH，不能只靠镜像标签
很多人以为拉取 golang:1.22-alpine 就能直接编译 Alpine 镜像，其实不然。Docker 官方 golang 镜像默认是 linux/amd64 构建环境，go build 输出仍是 Linux 二进制——哪怕你在 macOS 上跑这个容器，也得不到 Darwin 可执行文件。
正确做法是每次构建都显式传参：
- 编译 macOS 版：
docker run --rm -v "$PWD":/work -w /work golang:1.22 go build -o myapp-darwin -ldflags="-s -w" -trimpath -buildmode=exe -o myapp-darwin . - 编译 Windows 版：
docker run --rm -v "$PWD":/work -w /work -e GOOS=windows -e GOARCH=amd64 golang:1.22 go build -o myapp.exe . - 注意：
-trimpath和-ldflags="-s -w"必须加，否则二进制里含本地绝对路径，导致跨机器运行失败
Gin + Vue3 + Tauri 项目必须分开管理 Go 和前端依赖
很多新手把 go.mod 和 package.json 放同一目录，用 go run ./cmd/server 启动后发现前端资源 404，或热更新失效。根本原因是 Tauri 的构建流程要求前端必须先 pnpm build 输出到 src-tauri/target/debug/resources，而 Go 的 http.FileServer 默认不读这个路径。
关键动作只有两步：
- 在
src-tauri/tauri.conf.json中确认"build": { "distDir": "../dist" }指向的是 Vue3 的dist/目录（不是public/） - 启动时必须用
tauri dev，而不是直接go run—— 后者绕过 Tauri 的资源注入逻辑，Gin 根本收不到静态文件请求
如果你非要调试 Go 后端逻辑，得在 tauri.conf.json 里配 "devPath": "http://localhost:8080"，然后单独 go run ./cmd/server 启 Gin，再 tauri dev 连过去。这个双进程模式容易忽略 CORS 配置，gin.Default().Use(cors.New(cors.Config{AllowOrigins: []string{"http://localhost:1420"}})) 得写对端口。
