go version报错“不是内部或外部命令”的根本原因是windows未将go的bin目录（如c:\program files\go\bin）添加到path环境变量，需手动配置并重启命令行。
go version 命令没反应？先确认 PATH 是否生效
安装完 Go 后执行 go version 报 command not found，大概率是 PATH 没配对。Windows 安装 .msi 通常自动加了 C:\Go\bin，但若改过安装路径（比如装到 C:\Program Files\Go\），就得手动把 C:\Program Files\Go\bin 加进系统环境变量；macOS/Linux 下常见问题是改了 ~/.bashrc 却忘了 source ~/.bashrc，或者用了 zsh 却去改 bash 配置——检查当前 shell 类型用 echo $SHELL，再对应修改 ~/.zshrc 或 ~/.bashrc。
go mod init 报错“no Go files in current directory”？别急着写代码
运行 go mod init example.com/hello 时提示这个错误，不是模块初始化失败，而是你还没创建任何 .go 文件。Go 要求模块内至少有一个 Go 源文件才能完成初始化（哪怕只是空的 main.go）。正确顺序是：
- 先
mkdir hello && cd hello - 再
touch main.go（或直接echo 'package main' > main.go） - 最后
go mod init example.com/hello
否则 go mod 会拒绝生成 go.mod。
go run main.go 输出乱码或直接退出？检查 package 和 func main 位置
最常被忽略的是：Go 要求可执行程序必须同时满足两个硬性条件——package main 必须是文件第一行（前面不能有空行或注释），且 func main() 必须在同一个文件里、且不能带参数或返回值。以下写法全都会失败：
// 注释在 package 前 → 报错package main\n\nimport "fmt" → 中间空行 → 不报错但运行无输出（main 函数未被识别）func main(args []string) → 多了参数 → 编译失败
标准最小可行写法只有这四行，缺一不可：
package main
import "fmt"
func main() {
fmt.Println("Hello, Go!")
}
Linux/macOS 下 go install 工具失败？GOPROXY 和权限要分开看
执行 go install golang.org/x/tools/gopls@latest 卡住或报 cannot find module providing package，90% 是代理没设好。国内用户必须显式设置代理，否则默认 proxy.golang.org 无法访问：
- 运行
go env -w GOPROXY=https://goproxy.cn,direct（推荐 goproxy.cn） - 如果仍失败，检查是否用了
sudo go install——不要加sudo，go install默认写入$GOPATH/bin，而该目录属于当前用户，加 sudo 反而可能因权限错乱导致后续命令找不到二进制 - 验证安装是否成功：
which gopls应输出类似/home/xxx/go/bin/gopls
模块代理和本地 bin 目录权限是两件事，混在一起配容易白忙活。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
