推荐直接下载官方二进制包安装go，避免系统包管理器滞后；需显式设置gobin，gopath非必需但建议设为$home/go；交叉编译应禁用cgo以确保可移植性。
直接装官方二进制，别碰系统包管理器
Linux 用 apt install golang、macOS 用 brew install go 看似省事，但实际会埋坑：版本滞后（比如 Ubuntu 24.04 默认还是 go1.21，而当前稳定版已是 go1.25.4），路径不统一（brew 装在 /opt/homebrew/Cellar/go/...，apt 装在 /usr/lib/go-1.21），后续 go env GOROOT 输出五花八门，CI/CD 或团队协作时极易出错。
正确做法是所有平台都去 go.dev/dl/ 下载对应压缩包或安装包：
- Windows：选
go1.25.4.windows-amd64.msi，默认装到C:Go，自动配好PATH - macOS：选
go1.25.4.darwin-arm64.pkg（Apple Silicon）或go1.25.4.darwin-amd64.pkg（Intel），默认装到/usr/local/go - Linux：下载
go1.25.4.linux-amd64.tar.gz，解压到/usr/local/go，再加export PATH=$PATH:/usr/local/go/bin到 shell 配置文件
验证只用两行命令：go version 和 go env GOROOT。只要输出的 GOROOT 是 /usr/local/go（macOS/Linux）或 C:Go（Windows），就说明路径干净、可控。
GOOS/GOARCH 交叉编译前必须关 cgo
你在 macOS 上执行 GOOS=windows GOARCH=amd64 go build -o app.exe main.go，结果生成的二进制在 Windows 上双击闪退？大概率是代码里用了 cgo（比如调了 net 包里的 DNS 解析、或引入了 sqlite3、openssl 等 C 依赖）。
cgo 会让 Go 编译器调用宿主机的 C 工具链（clang、gcc），而 macOS 的 clang 无法生成 Windows PE 格式可执行文件。此时要么：
- 禁用
cgo：构建前加环境变量CGO_ENABLED=0，例如CGO_ENABLED=0 GOOS=windows go build -o app.exe（适用于纯 Go 实现的库，如net/http、encoding/json） - 保留
cgo：就得用目标平台的 C 工具链——最稳的方式是用 Docker，比如docker run --rm -v $(pwd):/work -w /work golang:1.25.4 bash -c "cd /work && CGO_ENABLED=1 GOOS=windows GOARCH=amd64 go build -o app.exe ."
注意：CGO_ENABLED=0 后，net 包会回退到纯 Go 实现的 DNS 解析器（可能不兼容某些企业内网 DNS 配置），这是真实 trade-off，不是“设个环境变量就万事大吉”。
go.mod 是跨平台一致性的唯一锚点
很多人在 Windows 上开发，push 到 Git 后，同事在 Linux 上 go run main.go 报 cannot find module providing package——根本原因不是换系统，而是没初始化模块，或者误用了 GOPATH 模式。
从第一行代码开始就必须：go mod init example.com/myapp。这一步会生成 go.mod 和 go.sum，它们才是真正的依赖快照。后续无论在哪台机器上 go build，只要 go.mod 没改，拉下来的依赖 commit 就完全一致。
本文档主要讲述的是Android 操作系统的介绍；Android是基于Linux内核的操作系统，是Google公司在2007年11月5日公布的手机操作系统，早期由Google开发，后由开放手持设备联盟（Open Handset Alliance）开发。它采用了软件堆层（software stack，又名以软件叠层）的架构，主要分为三部分。底层Linux内核只提供基本功能；其他的应用软件则由各公司自行开发，部分程序以Java编写。希望本文档会给有需要的朋友带来帮助；感兴趣的朋友可以过来看看
务必检查三件事：
-
go env GO111MODULE输出必须是on（不是auto或off） -
.gitignore里明确留着go.mod和go.sum，但排除bin/、pkg/、vendor/ - 项目根目录下没有
vendor目录（除非你真需要锁定 vendor，否则它反而破坏跨平台一致性）
如果已有旧项目没开模块，别硬改 GOPATH 路径，直接进项目根目录跑 go mod init + go mod tidy，让工具自动迁移。
VS Code + gopls 配置要写死 go.goroot
VS Code 的 Go 扩展默认靠 PATH 找 go，但不同平台 go 位置不同，编辑器有时会误判（尤其 macOS 上同时装了 brew 版和官方版）。结果就是代码补全失效、跳转错乱、格式化用错工具。
解决方案：在项目根目录建 .vscode/settings.json，强制指定：
"go.goroot": "/usr/local/go",
Windows 用户写成：
"go.goroot": "C:\Go",
这样 gopls 就永远用你确认过的 Go 安装路径启动，不受系统 PATH 干扰。顺便把格式化工具也锁死：
"go.formatTool": "gofumpt"
注意：gofumpt 要提前装好（go install mvdan.cc/gofumpt@latest），否则编辑器会报错。这个配置放在工作区而非用户级，才能保证团队里所有人打开项目时行为一致。
真正容易被忽略的是：每次重装 Go 或换机器后，第一件事不是写代码，而是重新运行 go env GOROOT，然后更新 .vscode/settings.json 里的 go.goroot 值——差一个字符，整个 LSP 就瘫痪。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
