go 1.21+ 默认启用模块模式，go111module=on 是安全起点；gopath 不再强制要求但保留可兼容旧工具，需确认架构、清理旧环境、正确设置 goroot 和 path，配置 goproxy=https://goproxy.cn,direct，并推荐预装 gopls、dlv 等开发工具。

Go 1.21+ 已默认启用模块模式，GO111MODULE=on 是安全起点；GOPATH 不再强制要求，但保留它仍能避免部分老项目或工具（如 go get 旧用法）报错。

确认系统架构与清理旧环境

很多编译失败其实源于架构错配或残留配置。别跳过这步：

• 运行 uname -m（Linux/macOS）或 echo %PROCESSOR_ARCHITECTURE%（Windows），确认是 x86_64 还是 arm64，下载对应 Go 安装包
• 检查是否残留旧版 Go：执行 which go 或 where go，若指向 /usr/local/go 以外路径（如 /home/user/go/bin/go），说明可能有多个版本冲突
• 删除旧 GOPATH 下的 pkg 和 bin 目录（保留 src 仅当真有历史项目依赖）

安装 Go 并验证 GOROOT 与 PATH

GOROOT 必须准确指向解压/安装目录，否则 go build 可能找不到标准库。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。

下载

• Linux/macOS：解压后将 go/bin 加入 PATH，同时显式设置 GOROOT（哪怕它和默认路径一致）：
  export GOROOT=/usr/local/go
export PATH=$GOROOT/bin:$PATH
• Windows：在系统环境变量中新增 GOROOT（如 C:\Go），并把 %GOROOT%\bin 放到 PATH 开头
• 验证命令必须用 go version 和 go env GOROOT 两行，只看前者容易误判

初始化模块并绕过国内网络限制

国内拉取 golang.org/x/... 包失败是高频问题，靠改 GO_PROXY 就够，不用动 git 配置或手动替换 import 路径。

• 执行：
  go env -w GOPROXY=https://goproxy.cn,direct
  注意末尾的 direct —— 它保证私有仓库（如公司内网 Git）不走代理
• 新建项目时直接 go mod init myapp，不要进 $GOPATH/src 再 init，后者会触发 GO111MODULE=auto 的模糊行为
• 如果已有项目 go.mod 里出现 replace 指向本地路径，删掉它；现代 Go 不需要手动 replace 标准库子包

可选但推荐：预热 go install 常用工具

像 gopls、dlv 这类工具不随 Go 安装，且 VS Code Go 插件默认从 $GOBIN 查找它们。提前装好能避免调试时弹出“command not found”。

• 先确保 GOBIN 已设（例如 export GOBIN=$HOME/go/bin），并加入 PATH
• 运行：
  go install golang.org/x/tools/gopls@latest
go install github.com/go-delve/dlv/cmd/dlv@latest
• 验证：which gopls 应输出 $GOBIN/gopls，不是 $GOROOT/bin/gopls

真正容易被忽略的是 GOBIN 和 PATH 的顺序——如果 $GOROOT/bin 在 $GOBIN 后面，你 go install 的二进制文件永远无法被调用到。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！