go环境搭建失败八成是goroot、gopath、path配置错误或shell配置未生效；需确认go安装路径、正确导出环境变量并source配置文件，再验证go version。
Go 环境装不起来，八成不是 Go 本身的问题，而是 GOROOT、GOPATH、PATH 这三个环境变量没对上，或者系统默认 shell 配置文件（比如 ~/.zshrc）压根没生效。
macOS 上 go 命令找不到？检查 ~/.zshrc 和 /usr/local/go/bin
macOS Catalina 及以后默认用 zsh，但很多人改过 shell 或者没 source 配置文件，导致 go 命令在终端里报 command not found。
- 先确认 Go 是否真装进去了：
ls /usr/local/go/bin/go（官方 .pkg 安装路径）或brew --prefix go（Homebrew 安装） - 再看当前 shell 是什么：
echo $SHELL，输出是/bin/zsh就编辑~/.zshrc；是/bin/bash就改~/.bash_profile - 往配置文件末尾加这两行（注意路径要和你实际安装位置一致）：
export GOROOT=/usr/local/goexport PATH=$PATH:$GOROOT/bin - 执行
source ~/.zshrc，再运行go version—— 出版本号才算成功
go mod init 报错“cannot determine module path”？别跳过项目目录初始化
这是新手最常卡住的地方：直接在桌面或空目录下敲 go mod init，没指定模块名，Go 就不知道该写哪个包路径到 go.mod 里。
- 必须先进入一个有明确用途的项目目录，比如：
mkdir ~/go/src/myapi && cd ~/go/src/myapi - 再运行：
go mod init myapi（模块名建议用小写字母+短横线，避免大写或空格） - 如果目录名含空格或中文，
go mod会静默失败，错误信息藏在go list -m的输出里，别信“no error”提示 - 模块名不一定要和文件路径一致，但推荐保持一致，否则
import时容易混淆
HTTP 服务启动后访问 404？http.HandleFunc 的路由注册顺序和路径匹配规则很关键
http.HandleFunc 不是“添加路由”，而是把函数注册进默认的 http.DefaultServeMux，它按注册顺序匹配，且路径匹配是前缀式而非全等式。
- 如果你写了：
http.HandleFunc("/user", handlerA)和http.HandleFunc("/", handlerB)，那么所有以/user开头的请求（比如/user/profile）都会进handlerA，但/users会进handlerB（因为不以/user开头） - 想精确匹配，得自己判断
r.URL.Path == "/user"，或者用第三方路由器如gorilla/mux或gin -
http.ListenAndServe(":8080", nil)中的nil表示用默认多路复用器；传入自定义的http.ServeMux实例才能控制行为 - 端口被占时错误是
listen tcp :8080: bind: address already in use，不是 404，别被误导
国内 go get 下载超时或失败？必须设 GOPROXY，不能只靠 go env -w
从 2025 年起，goproxy.cn 已不再维护，现在主流可用的是 https://goproxy.io 或清华源 https://mirrors.tuna.tsinghua.edu.cn/goproxy/。只运行 go env -w GOPROXY=... 不够，还得确保 GO111MODULE=on 已启用。
- 执行：
go env -w GOPROXY=https://goproxy.io,direct（注意,direct不能少，否则私有模块拉不到） - 同时确认：
go env -w GO111MODULE=on（Go 1.16+ 默认开启，但某些旧脚本可能关掉） - 验证是否生效：
go env GOPROXY输出应为设置的地址；go list -m -u all能列出依赖说明代理通了 - 如果公司内网有私有仓库，
direct前要加域名白名单，比如GOPROXY=https://goproxy.io,https://git.internal.example.com/direct
真正容易被忽略的点是：Go 模块模式下 GOPATH 不再决定代码存放位置，但很多老教程还在教 $GOPATH/src，结果新项目建错地方，go run 找不到入口，go test 报 no Go files —— 其实只要 go.mod 在当前目录，Go 就认这是模块根目录，跟 GOPATH 无关。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
