go version报错说明go的bin目录未加入path，需将/usr/local/go/bin（macos/linux）或c:\go\bin（windows）添加至环境变量并重载配置文件（如source ~/.zshrc）后验证。
go version 命令报错或不识别
说明 Go 的 bin 目录没进系统 PATH，这是新手最常卡住的第一步。macOS/Linux 默认用 zsh，Windows 用图形界面配置，但路径写错、漏 reload、或用了错误的 shell 配置文件（比如在 ~/.bashrc 里写，却用 zsh 启动终端）都会导致命令找不到。
- macOS/Linux：确认修改的是
~/.zshrc（不是~/.bash_profile），添加export PATH=$PATH:/usr/local/go/bin后必须运行source ~/.zshrc - Windows：检查“系统属性 → 环境变量 → 系统变量 → Path”中是否包含
C:\Go\bin（默认安装路径），添加后需重启终端或命令提示符 - 验证方式：新开一个终端窗口，直接执行
go version；如果仍失败，运行which go（macOS/Linux）或where go（Windows）看是否返回路径
go env GOPATH 显示为空或不是预期路径
现代 Go（1.16+）已默认启用模块模式（GO111MODULE=on），GOPATH 不再是依赖存放位置，但它仍是工作区根目录，影响 go install 安装的二进制工具路径（如 goctl）。若 go env GOPATH 为空，说明没显式设置，Go 会 fallback 到 $HOME/go，但部分工具（尤其老教程里的）可能依赖明确值。
- 建议显式设置：在
~/.zshrc或 Windows 环境变量中添加export GOPATH=$HOME/go（macOS/Linux）或GOPATH=C:\Users\YourName\go（Windows） - 不要把项目代码放在
$GOPATH/src下——这是 Go 1.11 之前的旧约定，现在任意路径都可go mod init -
go install生成的可执行文件会放$GOPATH/bin，确保该目录也在PATH中，否则装完工具无法直接调用
go mod init 报错 “cannot determine module path”
这是项目初始化时最典型的错误，根本原因是当前目录名含非法字符（如空格、中文、下划线开头）、或父路径含非 ASCII 字符、或目录名与已知导入路径冲突（例如叫 fmt 或 net/http）。
- 项目目录名只用小写字母、数字、短横线（
-），避免_、空格、中文，例如my-api可行，my_api或我的项目不行 - 路径中不要出现
golang.org、github.com等常见模块前缀，除非你真要发布到对应域名下 - 最简初始化：进入空目录，运行
go mod init example.com/hello（模块路径可任意，不需真实存在），之后go run .就能跑起来
go run . 提示 “no Go files in current directory”
不是环境问题，而是文件命名或内容不符合 Go 规范。Go 要求入口文件必须是 .go 后缀，且至少含一个 package main 和 func main() 函数。
- 文件名不能是
main.go.txt或隐藏文件（如.main.go），必须是main.go - 内容必须以
package main开头，且有且仅有一个func main() { ... } - 如果用了
go mod init，但文件里 import 了未声明的包（如import "fmt"），go run会自动下载依赖，无需手动go get
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
