go version没反应是因path未包含go的bin目录；windows需手动添加d:\go\bin等实际路径，macos/linux要补export path=$path:/usr/local/go/bin，用which go或where go验证是否生效。
go version 命令没反应？先确认 PATH 是否包含 go 的 bin 目录
执行 go version 报“命令未找到”或直接闪退，基本是 PATH 没配对。Windows 上安装 MSI 包默认会加 %GOROOT%\bin 到系统 PATH，但如果你手动改过安装路径（比如装到 D:\Go），就得自己补上 D:\Go\bin；macOS/Linux 手动解压安装的，常见漏掉 export PATH=$PATH:/usr/local/go/bin 这一行。
验证方式：在终端里运行 which go（macOS/Linux）或 where go（Windows），有输出路径才算到位。没输出就别急着写代码——go run 依赖这个可执行文件能找到。
go run hello.go 报错 “cannot run non-main package”？检查包声明和函数签名
这个错误只说明一件事：Go 没认出这是个可执行程序。核心条件只有两个：package main 必须存在，且文件里必须有且仅有一个 func main()，它不能带参数、不能有返回值。
- 常见手误：
package hello或package HelloWorld—— 可执行程序只能用main - 函数名写成
Func Main()、func Main()或func main(int)都会触发该报错 - 文件里如果同时存在
package main和package utils（哪怕注释掉），也会被判定为非 main 包
只要满足 package main + func main()（无参无返回），哪怕 import 语句空着、甚至没 import，go run hello.go 也能成功启动（只是可能 panic）。
用 VS Code 跑不起来？别急着装插件，先试终端原生命令
VS Code 的 Go 插件（如 golang.go）和 code-runner 在模块初始化、代理、GOPATH 冲突等场景下容易卡住或报一堆红波浪线。最快速验证环境是否真通的方式，是绕过 IDE：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 关掉 VS Code
- 打开终端，cd 到
hello.go所在目录 - 直接敲
go run hello.go
如果终端能跑通，说明 Go 环境本身没问题，问题出在插件配置或 workspace 设置里。这时候再查 settings.json 里有没有误配 "go.gopath"、"go.useLanguageServer"，或者是否启用了被墙的代理导致插件下载失败。
go mod init 是必须的吗？简单脚本不用管它
对单文件 Hello World 来说，go mod init 完全不是必需步骤。Go 1.16+ 默认启用 module 模式，但它只在你 import 第三方包（比如 github.com/sirupsen/logrus）或显式调用 go mod init 时才生成 go.mod 文件。
纯标准库调用（如 fmt、os）的 hello.go，直接 go run 即可，不会报错也不会强制要求模块。强行加 go mod init example.com/hello 只会让目录多一个 go.mod，对运行没影响，但初学阶段容易把注意力引向无关细节。
真正需要关注模块的时机，是你第一次想 go get 外部包、或者项目开始拆分成多个 .go 文件并需要版本控制的时候。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
