go 1.23.x 环境需显式配置才真正可用：必须清理旧版 /usr/local/go、设 goroot=/usr/local/go 并置于 path 开头、执行 go env -w goproxy=https://goproxy.cn,direct，且验证 go mod init 和 go list -m 成功。
Go 1.23.x 环境能直接用，但默认配置已不兼容老项目习惯——尤其是 GOPATH 和模块代理行为。
go version 显示成功 ≠ 环境 ready
很多用户执行 go version 看到输出就以为装完了，结果 go run main.go 报 no required module provides package。这不是安装失败，是 Go 1.23 默认强制启用 Modules，且不再自动识别 $GOPATH/src 下的代码目录结构。
- Go 1.21+ 已彻底弃用 GOPATH 模式作为默认开发方式，
GO111MODULE默认为on，哪怕你在$GOPATH/src里放了代码也不生效 - 验证是否真就绪：进任意空目录，运行
go mod init example.com/test，再go list -m—— 能输出模块名才算通过 - 若仍想临时退回到 GOPATH 模式（仅调试旧项目），需显式执行
go env -w GO111MODULE=off，但不推荐长期使用
Linux/macOS 下 /usr/local/go 路径要手动清理旧版本
Go 官方 tar.gz 包不会覆盖安装，解压到 /usr/local 时若已有 go 目录，新版本会直接合并进去，导致 GOROOT 指向混乱、go version 显示旧版、gopls 启动失败。
- 正确做法：安装前先删旧版，
sudo rm -rf /usr/local/go（Linux）或sudo rm -rf /usr/local/Cellar/go（macOS Homebrew 用户需额外brew uninstall go） - PATH 中只加
$GOROOT/bin，不要加$GOPATH/bin—— Go 1.23+ 的工具链（如gopls、dlv）默认安装到$GOPATH/bin，但调用时依赖 PATH，而多数人漏配 - 检查
GOROOT是否干净：运行go env GOROOT，输出必须和你解压路径完全一致，不能是/usr/local/Cellar/go/1.21.1/libexec这类 Homebrew 的嵌套路径
国内用户必须配 GOPROXY，否则 go mod download 卡死
Go 1.23 默认使用 https://proxy.golang.org，该域名在国内 DNS 解析常超时或返回空响应，表现为 go mod tidy 卡在 “verifying” 或报 Get "https://proxy.golang.org/...": dial tcp: i/o timeout。
- 立即生效的配置命令：
go env -w GOPROXY=https://goproxy.cn,direct（推荐）或go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct -
direct是关键后缀，表示当代理无法命中时回落到直连，避免私有模块拉取失败 - 如果公司内网有自建 Artifactory 或 JFrog，把
https://repo.yyrd.com/artifactory/aliyun-golang/替换进去即可，无需改其他逻辑
VS Code 中 gopls 启动失败多半是 go binary 版本不匹配
VS Code 的 Go 插件依赖 gopls 提供语义高亮、跳转、补全。Go 1.23 发布后，旧版 gopls（如 v0.13.x）会因协议变更拒绝启动，日志里出现 unsupported protocol version 或直接静默退出。
- 必须重装匹配版本：
go install golang.org/x/tools/gopls@latest（注意不是@stable） - 装完后重启 VS Code，再进命令面板（
Ctrl+Shift+P）运行Go: Restart Language Server - 检查是否生效：打开任意
.go文件，底部状态栏应显示gopls (v0.14.x)，其中 x 应 ≥ 3（2026 年中主流是 v0.14.4+）
最易被忽略的是：Go 1.23 开始，go env -w 写入的配置会存到 $HOME/Library/Application Support/go/env（macOS）、$HOME/AppData/Roaming/go/env（Windows）或 $HOME/.config/go/env（Linux），而不是直接改 shell 配置文件。这意味着你改了 ~/.zshrc 里的 GOROOT，但 go env GOROOT 仍返回旧值——优先级上，go env -w 的设置高于环境变量。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
