go命令能正常执行且go mod能自动拉取依赖，才是环境真正就绪的标志；需验证go version、go mod init和goproxy配置是否生效，确保path、模块模式和代理三者协同工作。
go 命令能正常执行，且 go mod 能自动拉取依赖，才是环境真正就绪的标志——不是装完就完事，而是命令链路通、代理可用、模块模式生效。
验证 go 是否真可用，别信安装器“自动配置”
Windows/macOS 安装 .msi 或 .pkg 后，常因终端未重启导致 go version 报 command not found。Linux 用户解压 .tar.gz 后，更需手动把 /usr/local/go/bin 加进 PATH。
- macOS/Linux：运行
which go，无输出就说明没生效；检查~/.zshrc或~/.bash_profile是否含export PATH=$PATH:/usr/local/go/bin，改完记得source ~/.zshrc - Windows：PowerShell 中执行
Get-Command go，失败则去「系统属性 → 高级 → 环境变量」确认%GOROOT%\bin已加入系统或用户PATH - 无论哪一平台，改完环境变量后必须新开终端，旧窗口不会自动 reload
go mod init 失败？先清掉这三样东西
常见现象是执行 go mod init example.com/foo 后，go.mod 为空或模块名被错误推导成 github.com/xxx/yyy。本质是当前目录残留了干扰项。
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 删掉项目根目录下的
vendor/目录（除非你明确要用 vendor 模式） - 运行
go env -w GO111MODULE=on强制启用模块模式（Go 1.16+ 默认开启，但 CI 或老脚本可能关着） - 确保不在
$GOPATH/src下新建项目——Go 会试图按旧路径推导 module 名，比如src/github.com/user/proj会生成github.com/user/proj，而不是你想要的example.com/foo
国内拉包超时？GOPROXY 必须配，且顺序不能错
不配代理时，go get 或 go mod tidy 卡在 Fetching github.com/xxx/yyy 是常态。官方源 proxy.golang.org 在国内基本不可用。
- 执行这三条命令（永久生效）：
go env -w GO111MODULE=ongo env -w GOPROXY=https://goproxy.cn,directgo env -w GOSUMDB=sum.golang.org -
https://goproxy.cn是七牛云维护的稳定镜像，direct表示代理查不到时回源官方，不能省略 - 验证是否生效：
go env | grep GOPROXY应输出GOPROXY="https://goproxy.cn,direct" - 若公司内网有私有代理，可替换为
https://your-proxy.example.com，但务必保留,direct
VS Code 里 gopls 启动失败，往往不是插件问题
gopls 是 Go 官方语言服务器，不是装个插件就自动工作。它依赖三个硬条件同时满足：
-
go命令必须在终端和 VS Code 的集成终端中都可用（检查 VS Code 终端里能否执行go version） - 项目根目录下必须有有效的
go.mod文件（go mod init成功后才有） - 文件后缀必须是
.go，且不能放在vendor/或testdata/这类被 gopls 忽略的目录里
最常被忽略的是：VS Code 默认继承系统 shell 的 PATH，但如果你用 zsh 而 VS Code 启动自 bash，go 就可能找不到——建议在 VS Code 设置里勾选 “Use Integrated Terminal’s Environment”，或统一 shell 类型。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
