根本原因是path未正确配置或未生效，即未将go的bin目录（如/usr/local/go/bin或%goroot%\bin）加入path，或修改后未source配置文件、未重启终端。
go version 命令报错：command not found
根本原因不是 Go 没装，而是 PATH 没生效或指向错误路径。常见于解压后没把 /usr/local/go/bin（Linux/macOS）或 %GOROOT%\bin（Windows）加入 PATH，或者改了配置文件但忘了 source ~/.zshrc 或重启终端。
- 检查当前 shell 配置文件（
~/.zshrc、~/.bashrc或 Windows 系统环境变量）是否真写了export PATH=$PATH:/usr/local/go/bin - 执行
echo $PATH看输出里有没有/usr/local/go/bin；Windows 用echo %PATH% - 别依赖 GUI 应用自动加载 shell 配置——VS Code 终端、iTerm、Alacritty 都要手动 reload 或新开窗口
- 如果用 Homebrew 安装的 Go，路径可能是
/opt/homebrew/bin（Apple Silicon）或/usr/local/bin（Intel），不是/usr/local/go/bin
go mod init 后 go get 仍超时或 403
这不是模块本身有问题，是 GOPROXY 没启用或设错。Go 1.13+ 默认开启模块模式，但国内默认代理 proxy.golang.org 不可达，且部分镜像（如 goproxy.cn）已停服（2025 年底起），继续用会返回 403。
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 确认
GO111MODULE已启用：go env -w GO111MODULE=on - 换用仍在维护的代理，例如：
go env -w GOPROXY=https://goproxy.io,direct或https://mirrors.aliyun.com/goproxy/ - 私有仓库必须加
GOPRIVATE，否则代理会跳过认证：go env -w GOPRIVATE=git.internal.company.com - 避免写成
https://goproxy.cn——该域名自 2026 年初已重定向至商业页面，不再提供代理服务
VS Code 提示 “package not found” 或 gopls 启动失败
编辑器找不到包，90% 不是代码问题，而是 gopls 没装、版本不匹配，或 GOPATH/GOROOT 路径和编辑器认知不一致。
- 先手动安装最新
gopls：go install golang.org/x/tools/gopls@latest - 检查
$GOPATH/bin是否在PATH中，并确认gopls可执行：which gopls - VS Code 的 Go 扩展设置里，禁用 “Auto-generate GOPATH” 选项，显式填入你实际的
GOPATH（如/Users/xxx/go） - 若用 Go 1.22+，
gopls要求 Go 版本 ≥ 1.20，旧版gopls会静默退出
多个 Go 版本共存时 go run 用错版本
系统里同时装了 Go 1.21 和 1.23，但 go run 总调用旧版本——因为 PATH 里靠前的 go 二进制优先被选中，和 GOROOT 无关。
- 用
which go查看当前生效路径，再用/path/to/go1.23/bin/go version对比确认 - 不要靠修改
GOROOT切换版本，它只影响go env输出，不改变PATH查找顺序 - 推荐用
gvm或asdf管理多版本：asdf install golang 1.23.0→asdf global golang 1.23.0 - 临时切版本可直接调用全路径：
/usr/local/go1.23/bin/go run main.go
echo $PATH、go env GOPROXY、which gopls 连查三行，比重装十遍更省时间。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
