go version报错90%是PATH未配置：Windows需将C:\Go\bin加入系统环境变量，Linux/macOS需在~/.zshrc等文件中添加export PATH=$PATH:/usr/local/go/bin并source；验证用which go或where go。
go version 报错或找不到命令，90%是 PATH 没配对
装完 Go 却敲 go version 提示“command not found”，不是安装失败，而是 shell 根本没找到 go 这个二进制文件。Windows 安装 MSI 时若没勾选 “Add Go to PATH”，或者 Linux/macOS 手动解压后忘了改 ~/.bashrc 或 ~/.zshrc，都会卡在这一步。
- Linux/macOS：确认是否执行了
export PATH=$PATH:/usr/local/go/bin（官方包默认路径）或export PATH=$PATH:/opt/homebrew/bin（Homebrew 安装路径），然后运行source ~/.zshrc（或对应配置文件） - Windows：必须把
C:\Go\bin加到「系统环境变量」的PATH中，加到用户变量里在某些终端（如 VS Code 集成终端）里可能不生效 - 验证方式：先跑
which go（macOS/Linux）或where go（Windows），有输出才算真正“可见”；再跑go version
GO111MODULE=on 不是可选项，是必须项
Go 1.16 起默认开启模块模式，但很多旧教程仍教你在 $GOPATH/src 下建项目、靠目录结构隐式启用模块——这在 Go 1.22 下极易触发 go: cannot find main module 错误，尤其当你新建项目又随手放在桌面或 Downloads 目录时。
- 统一执行
go env -w GO111MODULE=on，彻底关闭“auto”模式的歧义行为 - 新建项目直接在任意路径下运行
go mod init myapp，不用管GOPATH；老项目如果go.mod残缺，删掉它再重来，别硬调兼容 -
go get在 Go 1.20+ 默认不再自动写入go.mod，想引入新包请用go get github.com/sirupsen/logrus@latest，或更稳妥地：先在代码里import，再跑go mod tidy
国内用户不设 GOPROXY，go mod download 就会卡住
Go 1.22 的模块依赖默认走 proxy.golang.org，国内直连基本超时，表现为 go mod download 卡在某个包、go run 启动极慢，甚至报 Get "https://proxy.golang.org/...": dial tcp: i/o timeout。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 立即设置代理：
go env -w GOPROXY=https://goproxy.cn,direct（推荐，稳定且支持私有模块） - 若公司有内网镜像，可换成
https://goproxy.your-company.com,direct - 注意
direct必须保留，否则私有仓库（如 GitHub private repo）会因认证失败而拉不到
Docker 里跑 Go 开发，别直接用 golang:1.22 镜像
官方镜像精简过头，golang:1.22-slim 缺 git 和 gcc，golang:1.22-alpine 连 bash 都没有，导致你 clone 不了私有库、编译不了 cgo、调试器 dlv 装不上，最后只能 docker exec -it xxx /bin/sh 里手动补工具——这不是开发，是修车。
立即学习“go语言免费学习笔记（深入）”；
- 基础开发镜像至少要装：
git、curl、gcc、libc6-dev（Debian 系）、dlv（go install github.com/go-delve/delve/cmd/dlv@latest） - VS Code Remote-Containers 调试前，确认
launch.json里port和host匹配容器暴露端口（如2345），且program路径指向容器内路径（如/workspace/main.go），不是宿主机路径 - 挂载代码时用
volumes绑定到/workspace，别绑定到/go/src——模块模式下，go.mod位置决定工作区，路径混乱会导致go run找不到主包
Go 1.22 的整数 range 和 for 循环变量作用域修复是真有用，但前提是你的环境能跑起来；很多人卡在第一步，就永远看不到这些改进。
