go version无反应说明path和goroot未生效；需检查windows的%goroot%\bin或macos/linux的$goroot/bin是否加入path，用go env goroot验证，不报错且有输出即配置正确。
go version 命令没反应？先确认 PATH 和 GOROOT 是否生效
安装完 Go 后执行 go version 报“不是内部或外部命令”或直接无输出，基本是环境变量没配对。Windows 上常见原因是 %GOROOT%\bin 没加进系统 PATH；macOS/Linux 则多因 shell 配置文件（如 ~/.zshrc）里漏写了 export PATH=$PATH:$GOROOT/bin。
验证方式：在终端里分别运行
go env GOROOT go env GOPATH
如果报错或返回空，说明 GOROOT 根本没被识别——此时别急着重装，先检查安装路径是否和你设置的 GOROOT 一致（比如 macOS 默认是 /usr/local/go，但 Homebrew 安装可能落在 /opt/homebrew/opt/go/libexec）。
- Windows 用户建议用 PowerShell 运行
$env:GOROOT查看当前值，再对比安装目录 - Linux/macOS 用户用
which go反推实际二进制位置，再反向修正GOROOT - 别把
GOROOT和GOPATH搞混：GOROOT是 Go 安装根目录，GOPATH是你写代码、放依赖的地方（Go 1.16+ 默认启用 module 后，GOPATH对项目构建影响已大幅降低，但go install仍依赖它）
go run 和 go build 的区别不止是“运行 vs 编译”
go run main.go 看似方便，但它每次都会重新编译临时二进制再执行，不生成可部署文件；go build main.go 则生成一个同名可执行文件（如 Windows 下是 main.exe），适合分发或调试。
真正容易踩坑的是模块上下文：
- 如果当前目录没有
go.mod，go run会尝试按 GOPATH 模式找包，可能意外导入旧版本依赖 -
go build -o myapp能指定输出名，但若项目含多个main包（比如cmd/server和cmd/cli），必须明确指定路径：go build -o server ./cmd/server - 跨平台编译需提前设环境变量，例如在 macOS 上编译 Windows 版：
GOOS=windows GOARCH=amd64 go build -o app.exe main.go
go mod init 后 go get 总失败？代理和模块模式是关键
国内用户执行 go get github.com/gin-gonic/gin 卡住或报 timeout，99% 是没开 module 代理。Go 1.13+ 默认开启 GO111MODULE=on，但默认代理 https://proxy.golang.org 在大陆不可达。
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
解决只需一行：
go env -w GOPROXY=https://goproxy.cn,direct
注意 direct 不能省——它表示对私有仓库（如公司内网 Git）直连，否则所有非公开包都会失败。
- 验证代理是否生效：
go env GOPROXY应返回你刚设置的地址 - 如果依赖中含私有模块，还需补
go env -w GONOPROXY=git.example.com -
go get后不自动更新go.sum？加-u参数：go get -u github.com/sirupsen/logrus
go fmt 和 goimports 不是可选项，而是协作前提
团队里有人用 go fmt，有人用 goimports，结果提交时 import 块反复增删——这不是风格问题，是工具链没对齐。
go fmt 只格式化代码缩进/空格/换行；goimports 额外管理 import 分组（标准库、第三方、本地包）和自动增删 import 行。VS Code 默认用 goimports，但命令行里它不在 Go 标准工具集里，得手动装：
go install golang.org/x/tools/cmd/goimports@latest
装完后，推荐统一配置编辑器使用 goimports 作为格式化工具，否则每次 go fmt 都会把刚加的 import 又删掉。
- CI 流水线里建议加
go fmt -l检查：有未格式化文件就非零退出 - 别在
vendor目录里跑go fmt——它会破坏依赖锁定 - Go 1.23+ 开始，
go fmt默认行为已等价于goimports，但老项目仍需显式切换
go env -w 设置的变量只对当前 shell 生效，重启终端后可能回退。尤其 GOPROXY 和 GO111MODULE 这类开关型变量，一旦失效，整个依赖流程就卡在第一步。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
