先关掉所有终端再重试，90%是因为未重启终端导致PATH未生效；若仍失败，需检查GOROOT路径是否匹配实际安装位置，避免临时set设置引发冲突。
go version 命令报错或无输出？先关掉所有终端再重试
安装 .msi 包后，go version 报 'go' 不是内部或外部命令，90% 是因为没重启终端。Windows 的 .msi 确实会写入系统环境变量，但 CMD/PowerShell 启动时只读取一次，旧窗口不会自动刷新。
实操建议：
- 关闭所有已打开的 CMD、PowerShell、VS Code 终端、Git Bash 窗口
- 重新打开一个全新终端，再执行
go version - 若仍失败，检查
GOROOT是否被手动修改过（比如设成C:\Go但实际装在D:\software\Go） - 不要用
set GOROOT=...临时设置——它只对当前窗口生效，且容易和go env -w冲突
go mod init 失败：no Go files in current directory
运行 go mod init example.com/hello 却提示找不到 Go 文件，不是命令错了，而是你还没创建 main.go。Go Modules 初始化不依赖文件存在，但某些旧版工具链或 IDE 插件会误判空目录。
正确做法：
立即学习“go语言免费学习笔记（深入）”；
- 先新建
main.go，哪怕只写三行：
package main
import "fmt"
func main() {
fmt.Println("ok")
}
- 再执行
go mod init example.com/hello—— 此时go才会识别这是个 Go 项目并生成go.mod - 如果已有
go.mod但想重置，直接删掉它再go mod init即可，无需清理go.sum - 模块名不必对应真实域名，
hello或myapp都合法，只要不带空格和特殊字符
go run 和 go build 的区别：什么时候该用哪个？
go run 适合开发调试，go build 用于产出可分发的二进制。它们底层都编译，但行为差异直接影响迭代效率和部署逻辑。
关键区别：
-
go run main.go：编译后立即执行，临时文件自动清理，不能跨平台编译 -
go build（无参数）：生成与当前系统匹配的可执行文件，文件名默认为目录名 -
go build -o ./bin/app：指定输出路径和文件名，推荐用于 CI/CD 脚本 -
go build -ldflags="-s -w"：剥离调试符号和 DWARF 信息，可让二进制小 30%～50%，上线前建议加 - 注意：
go run .会自动找main包，但go build .默认不输出文件，必须加-o才生成
GOPROXY 配置失效？检查 direct 是否拼错
国内拉包超时、go get 卡住，大概率是代理配置漏了 ,direct。很多教程只写 https://goproxy.cn，但缺少 fallback 会导致私有模块或本地路径无法解析。
必须执行的三条命令（顺序无关）：
-
go env -w GO111MODULE=on—— 强制启用模块，避免 GOPATH 模式干扰 -
go env -w GOPROXY=https://goproxy.cn,direct—— 注意逗号后是direct，不是direct://或其他变体 -
go env -w GOSUMDB=sum.golang.org—— 国内可用，若企业内网需禁用则设为off
验证是否生效：go env GOPROXY 应输出 https://goproxy.cn,direct。如果显示空或 https://proxy.golang.org,direct，说明上一步没写成功。
真正卡住的地方往往不是安装步骤，而是环境变量刷新时机、模块初始化顺序、以及代理 fallback 的拼写细节——这些点不显眼，但每一步都会让构建慢 2 分钟以上。
