go version报错或显示旧版本，说明path未正确配置或存在多版本冲突；go mod init失败因路径含空格/大写；国内依赖超时需设goproxy=https://goproxy.cn,direct；vs code插件安装失败多因goproxy未生效或缺少编译工具。
go version 命令报错或显示旧版本
常见现象是执行 go version 后提示命令未找到，或输出版本低于 1.21（比如 1.19），说明系统可能装了多个 Go 版本，或者 PATH 没配对。
Linux/macOS 下检查实际安装路径：which go；再看环境变量是否指向正确位置：echo $PATH。如果 /usr/local/go/bin 不在其中，就补上：export PATH=$PATH:/usr/local/go/bin（写进 ~/.zshrc 或 ~/.bashrc 后 reload）。
Windows 用户容易卡在 PATH 没生效——改完系统环境变量后，必须重启终端（不是关掉再开，而是彻底新建一个 PowerShell 或 CMD 窗口）。
- 别用 brew install go（macOS）后又手动装官方包，容易冲突
- 卸载旧版时，删干净
/usr/local/go和$HOME/sdk/go*（JetBrains SDK 目录里可能藏旧版） -
go env GOROOT应该指向你刚装的目录，如果不是，用go env -w GOROOT=/usr/local/go强制修正
go mod init 失败：module path 不能含空格或大写字母
执行 go mod init my-project 报错 invalid module path，大概率是因为项目路径含中文、空格，或模块名用了驼峰（如 MyProject）。
Go 要求模块路径符合导入语法规范：只能是小写字母、数字、连字符、点号，且不能以数字开头。它最终会作为 import 路径出现，比如 github.com/you/my-project。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 项目目录名建议全小写 + 连字符，例如
user-service，而非User_Service - 初始化时直接用完整路径：
go mod init github.com/yourname/user-service，避免后续重命名麻烦 - 如果已在错误路径下 init，删掉
go.mod和go.sum，cd 到合规路径再试
国内依赖下载超时或失败
go get 卡住、timeout、403，基本是 GOPROXY 没设或设错。Go 1.13+ 默认开启模块代理，但国内直连 goproxy.io 或 proxy.golang.org 通常不可靠。
推荐一行搞定：go env -w GOPROXY=https://goproxy.cn,direct。注意末尾的 ,direct ——它表示对私有域名（如公司内网 git 地址）不走代理，直接拉取。
- 别只设
GOPROXY=https://goproxy.cn，漏掉,direct会导致私有库无法 fetch - 验证是否生效：
go env GOPROXY输出应含goproxy.cn - 某些企业防火墙会拦截 HTTPS 代理，可临时切回
https://proxy.golang.org测试是否网络策略问题
VS Code 的 Go 插件反复提示“Installing tools”失败
这是最常被忽略的环节：插件默认试图安装 dlv（调试器）、gopls（语言服务器）等工具，但它们依赖 GOPROXY，且部分工具需编译（比如 gopls 在 Windows 上可能因缺少 build 工具失败）。
先手动装关键工具：GO111MODULE=on go install golang.org/x/tools/gopls@latest。如果报错，说明 GOPROXY 没生效，或网络不通。
- Windows 用户若提示 “gcc not found”，需装 TDM-GCC 或 MinGW-w64，否则
go install编译失败 - VS Code 设置里关掉自动安装（
"go.toolsManagement.autoUpdate": false），改用手动控制 -
gopls版本和 Go 版本要匹配：Go 1.21 对应gopls v0.14+，旧版可能崩溃
go version、go env GOPROXY、go list -m），别凭感觉往下走。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
