多平台通用的Golang开发环境搭建-Golang-PHP中文网

验证go安装成功需先运行go version输出版本号；若失败则检查path是否包含go的bin目录、goroot是否正确设置、终端是否重启生效，再通过go env、go run和go mod init进一步验证。

多平台通用的golang开发环境搭建

Go 开发环境本身不依赖 IDE，跨平台一致性的核心是：统一用官方二进制安装 go、强制启用模块模式、显式控制构建目标、编辑器配置不写死路径。只要这四点对齐，macOS 上写的代码在 Linux CI 里跑、Windows 上编译出 Linux 二进制，全都不翻车。

很多人执行 go version 报 command not found，不是没装，是 PATH 没生效。

macOS / Linux：运行 which go；没输出就检查安装路径（如 /usr/local/go/bin）是否加进了 ~/.zshrc 或 ~/.bash_profile 的 PATH
Windows：在 PowerShell 里运行 Get-Command go；失败就去「系统属性 → 高级 → 环境变量」确认 Go\bin 目录进了用户或系统 PATH
别信安装器勾选的“添加到 PATH”——它只改注册表或 shell 配置文件，不自动重载；要么重启终端，要么手动 source ~/.zshrc（macOS/Linux）或关闭重开 PowerShell（Windows）

本质是当前目录还在 $GOPATH/src 下，go mod init 会按旧 GOPATH 规则推导 module 名，比如变成 src/github.com/xxx/yyy 这种非法路径。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。

下载

运行 go env GOPATH 查当前 GOPATH，然后 pwd 看是否在它的 src/ 子目录里
如果是，直接 cd 到任意非 GOPATH 路径下再初始化，例如 mkdir ~/myproject && cd ~/myproject && go mod init example.com/myapp
顺手删掉项目根目录下的 vendor/（除非你明确要 vendor 依赖）
运行 go env -w GO111MODULE=on 强制启用模块模式；Go 1.16+ 默认开启，但某些 CI 脚本或老机器可能关着

Go 的交叉编译是原生支持的，但默认只生成当前系统的可执行文件。想在 macOS 上打出 Windows 版，不能靠打包或虚拟机，就一条命令。

常用组合：
- GOOS=linux GOARCH=amd64 go build -o app-linux main.go
- GOOS=darwin GOARCH=arm64 go build -o app-mac main.go
- GOOS=windows GOARCH=amd64 go build -o app.exe main.go
如果代码用了 cgo（比如调了 SQLite、OpenSSL），那必须对应平台有 C 编译器；此时推荐用 Docker 构建，例如 docker run --rm -v $(pwd):/work -w /work golang:1.22-alpine go build -o app-linux main.go
构建前建议先 go clean -cache -modcache，避免缓存污染导致不同平台行为不一致

gopls 不是插件装上就跑，它严格依赖 go 命令可用、go.mod 存在、文件后缀为 .go。

打开 VS Code 后，按 Cmd+Shift+P（macOS）或 Ctrl+Shift+P（Windows/Linux），输入 Go: Install/Update Tools，全选安装——尤其是 gopls 和 goimports
确保项目根目录有 go.mod；没有就 go mod init example.com/foo
检查当前打开的文件是不是 .go 后缀，且不在 vendor/ 或 testdata/ 这类被 gopls 忽略的目录里
工作区设置 .vscode/settings.json 里不要硬编码 go.goroot，让它自动发现；若非要指定，用相对路径或环境变量，别写死 C:\Go 或 /usr/local/go