go 1.16+ 标准安装无需装ide、配gopath或改环境变量；mac推荐brew install go（需先brew update），windows/linux建议官网安装包；避免第三方“一键安装器”；验证用go version和go env goroot/gopath；go mod init报错多因残留go.sum/vendor或目录名不合法；go build失败常因未在模块根目录执行；依赖下载失败优先检查goproxy配置。
不用装 IDE、不配 GOPATH、不改系统环境变量——Go 1.16+ 的标准安装方式，现在就能跑起来。
Go 官方安装包 vs brew install go？选哪个更稳
Mac 用户优先用 brew install go，但得确认 Homebrew 已启用最新仓库：brew update 后再装；Windows 和 Linux 直接下官网 go1.xx.x.darwin-arm64.pkg 或 .msi 包更可靠。别用第三方镜像站打包的“一键安装器”，它们常悄悄改 GOROOT 或塞进非标准 bin 路径，后续 go mod 报错概率高。
- 验证是否真装对：终端执行
go version，输出应含go1.18或更高（2023 年起建议至少 1.19） - 检查
GOROOT是否指向安装目录（如/usr/local/go），而不是用户家目录下的某个子文件夹 - 运行
go env GOROOT和go env GOPATH，前者必须是非空路径，后者在 Go 1.16+ 默认为$HOME/go，无需手动设
go mod init 报错 “cannot find module providing package” 怎么办
这是新员工最常卡住的地方：刚建好项目目录，一敲 go mod init myapp 就报错，其实和模块初始化无关，而是当前目录里已有 go.sum 或残留的 vendor/ 文件夹干扰了模块感知。
- 先删干净：
rm -f go.sum vendor/（Windows 用del /f /q go.sum & rmdir /s /q vendor） - 确保目录名不含空格、中文或点号开头（比如
my.app会触发解析异常） -
go mod init后立刻执行go mod tidy，它会自动补依赖、写go.mod，不是可选项 - 如果公司用私有模块代理，需提前配置：
go env -w GOPRIVATE=git.internal.company.com/*
写完 main.go 却提示 “no required module provides package …”
典型症状：文件里写了 package main 和 func main()，go run main.go 正常，但 go build 失败。问题出在模块根目录没对齐——go build 要求当前路径是模块根（即含 go.mod 的目录），而 go run 只认单文件。
- 执行前先
cd到go.mod所在目录，再go build -o ./bin/app - 别在子目录里执行构建命令，哪怕那里也有
main.go - 如果想跨目录构建，用完整包路径：
go build -o ./bin/app ./cmd/myapp（前提是cmd/myapp/main.go在模块内且路径合法） - 检查
go.mod第一行module声明是否与实际代码结构匹配，比如声明了module github.com/org/repo，那import语句就得用github.com/org/repo/pkg格式
真正麻烦的不是安装，是第一次 go mod download 拉依赖时遇到的网络超时或校验失败——这时候别硬等，先确认公司是否开了 GOPROXY，再看 go env GOPROXY 输出是不是 https://proxy.golang.org,direct 这种格式。内部 proxy 地址漏掉 https:// 或多了一个斜杠，都会静默失败。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
