go version能运行不代表环境ok，必须验证goroot/gopath/gobin路径正确、go run可执行、go mod init和go get能正常工作。
go version 能跑出来，不代表环境就 OK
很多新手看到 go version 输出了版本号，就以为安装完成了。其实这只是最表层的验证——GOROOT 可能没设对，GOPATH 可能指向了错误目录，甚至 GOBIN 没生效，后续 go install 生成的二进制根本找不到。
真正要确认的是：编译、运行、依赖管理、工具链这四件事能不能闭环。
-
go version正常输出（比如go version go1.22.5 darwin/arm64） -
go env GOROOT GOPATH GOBIN三者都返回非空且合理的路径（GOROOT应指向安装目录，GOPATH不应是/usr/local/go或系统默认路径） - 执行
go run main.go（含简单fmt.Println）能成功输出，不报command not found: go或cannot find package - 新建空目录，
go mod init example.com/test能生成go.mod，且后续go get github.com/google/uuid不卡在 proxy 或 checksum 错误
macOS 上 .zshrc 配置容易漏掉的关键点
macOS 默认 shell 是 zsh，但很多人直接改了 ~/.bash_profile 或 ~/.profile，结果终端新开一个窗口就失效。还有人把 export PATH=$PATH:$GOROOT/bin 写在 GOROOT 定义之前，导致变量未展开。
正确顺序和写法必须是：
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 先定义
GOROOT（例如export GOROOT=/usr/local/go） - 再定义
GOPATH（建议独立路径，如export GOPATH=$HOME/go） - 最后追加 PATH：
export PATH=$GOROOT/bin:$GOPATH/bin:$PATH - 保存后必须执行
source ~/.zshrc，不能只关掉终端再开——新开的 tab 才加载新配置 - 验证：在新终端里运行
echo $PATH，确认开头有/usr/local/go/bin或你设的GOROOT路径
go test 报错 “cannot find package” 的真实原因
这个错误常被误认为是包没装，其实八成是工作目录或模块初始化问题。Go 1.16+ 默认启用 module-aware 模式，不在 module 根目录下执行 go test 就会找不到本地包引用。
典型场景和解法：
- 你在项目根目录外执行
go test ./...→ 报错。解决：cd 进项目根（含go.mod的目录）再试 - 项目没
go.mod，但用了第三方包（如github.com/gorilla/mux）→go test会提示找不到，不是因为没go get，而是因为没go mod init - 测试文件里 import 的路径写成了绝对路径（如
import "myproject/handler"），但go.mod里 module 名是example.com/myproject→ 必须用完整 module path 导入 - 用
go test -v能看到具体哪一行 import 失败，比只看错误信息更准
Delve 调试器装了却连不上远程的常见断点
dlv 安装成功（dlv version 有输出）只是第一步。远程调试失败，往往卡在三个地方：代码路径映射、防火墙、以及 dlv 启动参数。
- 本地 IDE（如 Goland）的 “Mappings” 必须严格对齐远程路径，比如远程项目在
/home/user/myapp，本地映射就必须设为相同路径，不能是~/Projects/myapp - 远程服务器要开放
dlv默认端口（--headless --listen :2345），检查ufw status或iptables -L是否拦截 -
dlv启动命令里漏了--api-version=2，新版 Goland 默认用 v2 协议，不加这个参数会连接超时 - 远程运行
dlv exec ./myapp --headless --listen :2345 --api-version=2 --accept-multiclient，注意--accept-multiclient才支持多次 attach
路径不对、端口不通、协议版本错——这三个点任意一个没对上，调试器就只会显示 “connection refused” 或 “timeout”，而不是具体哪错了。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
