go 1.18 安装需正确配置 goroot、gopath、go111module 和 goproxy；goroot 通常无需手动设置，gopath 建议设为项目目录以兼容老项目，goproxy 必须设为国内代理（如 goproxy.cn）以防依赖拉取失败。
Go 项目能跑起来，不等于环境搭得对；很多构建失败、依赖拉不到、IDE 跳转失效的问题，根源都在初始环境配置没踩准点——尤其是 GOROOT、GOPATH、GO111MODULE 和 GOPROXY 这四个变量的组合逻辑。
go command not found？先查 PATH 和 GOROOT 是否真正生效
这是 macOS/Linux 上最常被忽略的第一步。Homebrew 安装或手动解压后，go 命令找不到，往往不是没装，而是 PATH 没刷进当前 shell 环境。
- 运行
which go，如果无输出，说明 PATH 没生效；有输出但路径怪（比如/opt/homebrew/bin/go和/usr/local/go/bin/go同时存在），说明多个安装混了 - 检查
GOROOT：运行go env GOROOT，输出应和你解压 Go 的路径一致（如/usr/local/go）；若为空或错，说明GOROOT没设，或设了但没 reload shell - Mac 用户注意 shell 类型：
~/.zshrc（Apple Silicon 默认）或~/.bash_profile（Intel 旧配置），别改错文件 - Windows 用户重点查系统环境变量里的
Path是否包含C:\Go\bin，且无空格或中文路径
go mod init 失败或依赖拉不动？GOPROXY 是国内用户的刚需
go mod download 卡住、go get 超时、go run 报 cannot find module providing package，90% 是代理没开或配错。
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 国内用户必须设代理：运行
go env -w GOPROXY=https://goproxy.cn,direct（中科大/七牛云维护，稳定） - 验证是否生效：运行
go env GOPROXY，输出应为上面那串 URL，不是https://proxy.golang.org,direct或空 - 不要用
go env -w GOPROXY=direct试错——这等于关掉代理，会直连被墙域名 - 某些企业内网需额外加私有代理，此时把
https://goproxy.cn替换为内部地址即可，格式不变
VS Code 跳转定义失效？gopls 版本和 GOPATH 冲突是主因
装了官方 Go 扩展却无法跳转、提示 “No definition found”，通常不是插件问题，而是语言服务器 gopls 没起来，或跟本地 Go 环境错位。
- 首次打开项目时，VS Code 会弹窗问是否安装工具链；点 “Install All”，它会自动装
gopls、dlv等；若跳过，手动运行go install golang.org/x/tools/gopls@latest - 如果用了
goenv或asdf切换 Go 版本，gopls必须对应当前项目所用版本；否则 VS Code 可能调用旧版gopls，报错 “gopls: unsupported version” -
GOPATH不影响模块项目，但部分老插件仍会读取它来定位src；若你把项目放在$GOPATH/src下，又开了模块模式，反而容易触发路径混淆——现代项目直接放任意目录 +go mod init即可
go build 编译慢或体积大？默认构建参数没调优
刚上手的人常以为 “能编出来就行”，但生产级项目从第一天就该关注构建效率和二进制体积，尤其在 CI/CD 或嵌入式场景下。
- 加
-ldflags="-s -w"：剥离调试符号和 DWARF 信息，体积直降 30–50% - 禁用内联可加快局部编译（适合开发阶段）：
-gcflags="all=-l"，避免函数内联干扰调试 - 避免用
air或gin run这类热重载工具——它们绕过go build缓存，每次都是全量 rebuild；推荐用fswatch+make触发 clean build - CI 构建时建议加
-mod=readonly，防止意外修改go.mod；本地开发用go mod tidy保持一致性即可
真正卡住人的从来不是“怎么装 Go”，而是几个关键环境变量之间的隐性依赖关系——比如 GOPROXY 不生效会导致 go mod init 表面成功实则缺依赖，GOROOT 错位会让 gopls 启动失败却不报错。这些点不显眼，但一漏就拖半天排查时间。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
