根本原因是path未正确配置或goproxy未设好；需确认goroot指向正确、path包含go二进制目录（如/usr/local/go/bin或c:\go\bin），并执行source或重启终端，再运行go version验证；国内还需设置go env -w goproxy=https://goproxy.cn,direct。
Go 环境装不上、go version 报“command not found”、go run main.go 提示找不到模块——这些问题基本都出在 PATH 没配对，或 GOPROXY 没设好。现代 Go（1.16+）不需要手动设 GOPATH，但 GOROOT 和 PATH 必须准确指向 go 二进制所在目录。
验证 go 命令是否真可用
别只信安装程序说“已完成”。打开新终端（不是安装时用的那个），直接运行：
go version
如果报错：command not found 或 'go' is not recognized，说明 PATH 没生效。常见原因：
- Windows 用户用了 .msi 安装但没重启终端（或没开新 cmd/PowerShell）
- macOS/Linux 用户改了
~/.zshrc或~/.bash_profile，但忘了执行source ~/.zshrc - Linux 手动解压到
/usr/local/go，却把PATH写成/usr/local/gobin（漏了/bin）
查路径是否正确：
which go
正常应返回类似 /usr/local/go/bin/go（macOS/Linux）或 C:\Program Files\Go\bin\go.exe（Windows）。没输出？那就得重配 PATH。
go mod init 失败：no module found / unknown revision
新建项目后执行 go mod init myapp 报错，通常不是命令问题，而是网络或代理没设好。Go Modules 默认会连官方 proxy（proxy.golang.org），国内直连大概率超时或失败。
立刻设置国内镜像：
go env -w GOPROXY=https://goproxy.cn,direct
这条命令永久写入 Go 环境配置，后续所有 go get、go mod tidy 都走镜像源。验证是否生效：
go env GOPROXY
输出应为 https://goproxy.cn,direct。注意末尾的 ,direct 很关键：它表示对私有仓库（如公司内网 Git）跳过代理，直连。
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
VS Code 中 gopls 报错或不工作
VS Code 装了官方 Go 扩展后，代码补全、跳转、诊断全失效，大概率是 gopls（Go language server）没装或版本不匹配。
手动装一次：
go install golang.org/x/tools/gopls@latest
装完检查是否在 PATH 里：
which gopls
如果返回空，说明 GOBIN 没加进 PATH。推荐统一设为：
- macOS/Linux：
export GOBIN=$HOME/go/bin，并确保该路径在PATH中靠前 - Windows：
set GOBIN=%USERPROFILE%\go\bin，并把该路径加入系统PATH
VS Code 重启后，状态栏右下角应显示 “gopls (running)”。若仍报错，点开 Output 面板，选 “gopls”，看具体错误——90% 是模块未初始化（缺 go.mod）或文件不在模块根目录下。
go run 启动失败：main package not in main.go
写好 main.go，运行 go run main.go 却提示 “main package not in main.go”，不是语法错，而是当前目录没初始化模块，或 main.go 不在模块根目录。
确认三件事：
- 当前目录下存在
go.mod文件（由go mod init xxx生成） -
main.go文件里第一行是package main（不能是package mylib） - 没有其他
.go文件意外声明了package main（比如你复制了另一个项目的main.go进来）
最简验证法：删掉当前目录所有文件，只留一个 main.go，执行：
go mod init temp<br>go run main.go
能跑通，说明问题出在项目结构或已有文件干扰上。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
