go环境配置需避开msi安装包、禁用gopath模式、正确设置go111module=on、vs code必装go/gopls/code spell checker并重载窗口，新建项目直接go mod init无需gopath。
Go 语言环境本身不复杂，但小白常卡在 GOPATH 和 GO111MODULE 的冲突、go install 找不到命令、或者编辑器里没语法提示——这些问题不是不会写代码，而是环境没对齐。
下载安装 go 命令行工具，别碰 MSI 安装包（Windows）
官网下载页面有 msi 和 zip 两种格式。Windows 用户优先选 zip 版：解压后把 bin 目录加进系统 PATH，就能直接用 go version 验证。MSI 安装包会偷偷改注册表、混用用户级/系统级环境变量，后续 go mod init 报错时很难排查。
- macOS 直接用
brew install go，别手动下载 pkg - Linux 用
tar -C /usr/local -xzf go*.tar.gz，再把/usr/local/go/bin加入~/.bashrc或~/.zshrc的PATH - 验证是否生效：终端新开一个窗口，运行
go env GOPATH—— 如果输出空或报错，说明PATH没生效
初始化模块前先关掉 GOPATH 模式
Go 1.16+ 默认启用模块模式，但很多旧教程还教人配 GOPATH。如果你在项目根目录运行 go mod init myapp 却提示 go: modules disabled by GO111MODULE=off，说明环境变量被手动设成了 off。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 检查当前设置：
go env GO111MODULE，正常应输出on - 如果输出
off，删掉~/.bashrc或~/.zshrc里类似export GO111MODULE=off的行 - 不需要设
GOPATH：现代 Go 项目直接在任意路径下go mod init即可，go会自动创建go.mod文件 - 顺手清理旧习惯：
rm -rf ~/go（除非你真在用GOPATH存第三方包）
VS Code 要装这 3 个扩展，且必须重载窗口
只装 Go 扩展不够，它依赖另外两个底层工具。装完不重载窗口，Ctrl+Click 跳转、自动补全、gopls 提示全失效。
- 必装扩展：
Go（by golang）、gopls（官方语言服务器）、Code Spell Checker（防拼错fmt.Println这类基础函数） - 装完点右下角弹出的
Reload Window，不是关掉再打开 - 首次打开
.go文件时，VS Code 会自动下载gopls二进制，如果卡住，手动执行：go install golang.org/x/tools/gopls@latest - 确认生效：新建
main.go，输入fmt.，看是否弹出Println等函数列表
运行第一个程序时，别在 $GOPATH/src 下建文件
很多教程说“把代码放 $GOPATH/src/hello”，这是 Go 1.11 之前的写法。现在这么做会导致 go run main.go 报错：cannot find module providing package，因为模块路径和实际目录不匹配。
- 正确做法：新建空文件夹（比如
~/projects/hello），cd 进去，执行go mod init hello -
main.go必须放在该目录下，且package main开头，否则go run不认 - 如果想发布到 GitHub，
go mod init的参数建议写完整路径，比如go mod init github.com/yourname/hello，避免后续go get出问题 - 执行
go run main.go成功后，再试go build—— 输出的二进制默认和目录名同名，不是main
最常被忽略的是：go 工具链本身不依赖 IDE，但 gopls 语言服务器对 go.mod 文件极其敏感。哪怕多一个空格、少一行 module 声明，编辑器里的红波浪线就停不下来。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
