go环境搭建核心是“能编、能调、能发”，需启用go111module=on、配置goproxy国内代理、设gopath=~/go并加入path，项目可任意路径，跨平台编译须指定goos/goarch且cgo_enabled=0。
个人开发者完全不需要复杂配置或专用服务器，用本地机器 + 最小必要环境就能跑通 Go 项目。关键不是“搭全”，而是“能编、能调、能发”。
go version 能跑，但 go mod init 报错：GO111MODULE 没开
Go 1.16+ 默认启用模块模式，但某些旧系统或手动安装的版本仍可能关闭它。不启用会导致 go mod init 失败，或依赖下载卡在 proxy.golang.org。
- 运行
go env -w GO111MODULE=on（永久生效） - 国内用户必须配代理：
go env -w GOPROXY=https://goproxy.cn,direct - 如果公司内网有私有模块，额外加：
go env -w GOPRIVATE=git.internal.company.com - 验证是否生效：
go env GO111MODULE GOPROXY应输出on和代理地址
GOPATH 还要不要设？设在哪最省事
现代 Go 项目（用 go mod）根本不需要把代码放 GOPATH/src 下，GOPATH 仅影响 go install 输出的二进制位置（即 $GOPATH/bin）。对个人开发者，设成 ~/go 最省心。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 执行：
mkdir -p ~/go/bin，然后export GOPATH=$HOME/go（写入~/.zshrc或~/.bashrc） - 顺手把
$GOPATH/bin加进PATH：export PATH=$PATH:$GOPATH/bin - 不用改
GOROOT——安装包会自动设好，go env GOROOT看一眼就行 - 项目可建在任意目录，比如
~/projects/myapi，和GOPATH无关
跨平台编译一个二进制，为什么本地 build 出来不能直接丢到 Linux 上跑
go build 默认按当前系统生成可执行文件。想从 macOS 编译 Linux 版，必须显式指定目标 OS 和架构，否则会报错或运行失败。
- 编译 Linux amd64 版：
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o myapp-linux . - 编译 Windows 版：
GOOS=windows GOARCH=amd64 go build -o myapp.exe . -
CGO_ENABLED=0关键：避免依赖 C 动态库，生成纯静态二进制，扔哪都能跑 - 查支持列表：
go tool dist list，里面带linux/amd64这种格式的才能用
VS Code 装了 Go 插件，但跳转/补全不工作
不是插件没装，而是底层语言服务器 gopls 没起来，或者工作区没识别为 Go 模块。
- 确保项目根目录有
go.mod文件（没有就go mod init example.com/foo） - 打开命令面板（
Cmd+Shift+P/Ctrl+Shift+P），搜 “Go: Install Tools”，勾选全部并安装 - 重点装
gopls—— 它是补全、跳转、诊断的核心，其他工具（如dlv）按需装 - 如果还是卡，删掉
~/.vscode/extensions/golang.go-*/out/tools，重启 VS Code 再触发安装
最容易被忽略的是：跨平台编译时忘了关 CGO_ENABLED，导致生成的二进制在目标机上缺 libc；还有就是 go env -w 设的环境变量只对当前 shell 生效，没写进配置文件就容易反复失灵。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
