go环境真正搭好需满足go version可执行、go mod init成功、第三方库能go install或go mod tidy成功；其他配置如path、gopath仅为支撑该结果，旧习惯易误导。
Go 环境能跑起来、第三方库能 go install 或 go mod tidy 成功，才是真“搭好了”。其他步骤全是为这个结果服务的，别被“配置 GOPATH”“改 PATH”这些旧习惯带偏。
go version 能执行，但 go mod init 报错：no module found
这是 Go 1.16+ 默认启用模块模式后最常见的假性失败。不是环境没装好，而是当前目录不在模块上下文里。
- 确保你在项目根目录下执行
go mod init myproject（myproject是模块名，建议用 GitHub 路径如github.com/yourname/myproject） - 如果提示
go: modules disabled by GO111MODULE=off，说明模块被手动关了——直接运行go env -w GO111MODULE=on - Windows 下 PowerShell 可能缓存旧环境变量，改完后新开终端再试，别信
go env输出里还显示off的旧值
国内拉不到 golang.org/x/ 包，比如 gopls、goimports
这不是网络问题，是 Go 官方域名在国内解析或连接超时。必须设代理，且要设对位置。
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（注意逗号后是direct，不是空格或分号） - 同时建议加一行：
go env -w GOSUMDB=sum.golang.google.cn，否则go mod download可能卡在 checksum 校验 - 验证是否生效：
go env | grep GOPROXY应输出GOPROXY="https://goproxy.cn,direct" - VS Code 的 Go 扩展如果仍报错，重启编辑器——它不会自动读取新环境变量
go install 第三方工具失败，提示 command not found
Go 1.17+ 后，go get 已弃用，所有工具必须用 go install，且安装路径默认是 $(go env GOPATH)/bin，但该路径未必在系统 PATH 里。
- 先确认 GOPATH：
go env GOPATH，假设输出/home/you/go，那工具实际装在/home/you/go/bin - 把这路径加进 shell 配置文件（
~/.zshrc或~/.bashrc）：export PATH=$PATH:$(go env GOPATH)/bin - 重载配置：
source ~/.zshrc，再运行which gopls看是否返回路径 - 常见工具安装命令（注意版本后缀）：
go install golang.org/x/tools/cmd/gopls@latest、go install mvdan.cc/gofumpt@latest
go mod tidy 后 vendor 目录没生成，或依赖没进 go.mod
go mod tidy 只处理显式 import 的包。它不扫描注释、字符串或未使用的变量。
- 检查
main.go或其他 .go 文件里是否真有import "github.com/gin-gonic/gin"这样的语句——少一个引号、多一个空格都不行 - 如果用了
_ "github.com/lib/pq"这种匿名导入，go mod tidy会识别；但如果是字符串拼接的包名（如"github.com/" + "gin-gonic/gin"），它完全无视 - 想强制拉某个包又不 import？不行。Go 模块机制不支持“预装”，必须先写 import，再
go mod tidy - vendor 目录默认不生成，要用
go mod vendor手动生成——但多数现代项目已不再需要它
真正容易被忽略的点是：Go 不靠 IDE 配置驱动，而靠终端里 go 命令的行为。VS Code 提示“找不到 gopls”，往往不是插件坏了，而是你终端里 which gopls 就没结果。先让命令行能跑通，编辑器自然就跟上了。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
