go环境只需官方二进制包+正确配置goroot、gopath和path即可运行；关键要验证which go/go env gopath/go version三件事，区分go run（临时执行）与go build（生成二进制），调试须用dlv debug或dlv exec而非go run，且需go mod init初始化模块并注意replace和--api-version 2等细节。
Go 环境不用装太多东西，官方二进制包 + 正确配置 GOPATH 和 PATH 就能跑起来；本地编译调试的关键不是 IDE，而是理解 go build、go run 和 dlv 的分工。
下载安装 Go 二进制包后必须验证的三件事
很多人装完就写 main.go，结果报 command not found: go 或 cannot find package。问题往往出在环境变量没生效或路径错位。
- 运行
which go（macOS/Linux）或where go（Windows CMD），确认输出的是你解压/安装目录下的bin/go路径 - 检查
go env GOPATH输出是否为你预期的路径（比如$HOME/go），不是空值或系统根目录 - 手动执行
go version，如果报错，说明PATH没包含 Go 的bin目录——把/path/to/go/bin加进PATH，然后source ~/.zshrc（或对应 shell 配置文件）
go run 和 go build 别混用：什么时候该编译，什么时候该直跑
go run 是临时编译并执行单个或多个 .go 文件，适合快速验证逻辑；go build 生成可执行文件，用于部署或反复调试。两者对模块路径、import 解析规则完全一致，但行为差异直接影响调试体验。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 用
go run main.go时，当前目录必须是 module 根（含go.mod）或GOPATH/src下的合法包路径，否则会报no required module provides package -
go build -o myapp .生成二进制后，可以用./myapp多次运行，也能配合dlv exec ./myapp进行断点调试 - 如果项目有多个
main包（如 CLI 和 server 分开），go run必须显式列出所有入口文件：go run cmd/cli/main.go cmd/server/main.go
用 dlv 调试时最常卡住的两个地方
dlv 不是 Go 自带的，得单独装；而且它和 go run 不兼容——想打断点，必须用 dlv debug 或 dlv exec 启动程序。
- 安装命令是
go install github.com/go-delve/delve/cmd/dlv@latest，装完检查dlv version，别漏掉@latest（否则可能装旧版，不支持 Go 1.21+ 的泛型调试） - 直接运行
dlv debug会在当前目录找main包并启动调试会话；若提示could not launch process: could not get executable path，大概率是没go.mod或当前不是 module 根目录 - 调试已编译的二进制更稳定：
dlv exec ./myapp --headless --listen :2345 --api-version 2，再用 VS Code 的dlv扩展连过去，比dlv debug少踩一半坑
别让 go mod init 毁掉本地调试节奏
新建项目第一件事不是写代码，而是执行 go mod init example.com/myapp。模块名不一定要是真实域名，但必须唯一且不含空格/大写字母——否则后续 import 会失败，dlv 也可能找不到源码映射。
- 模块名只是逻辑标识，不影响编译结果，但影响
go list -m、go vendor和调试器源码定位 - 如果已有代码但没
go.mod，直接go mod init后，运行go build会自动补全依赖版本到go.sum；但若之前用GOPATH方式开发过，记得删掉$GOPATH/src/xxx下同名路径，避免go命令优先加载旧包 - 本地调试时频繁改包名？可以临时用
replace在go.mod里指向本地路径：replace example.com/utils => ../utils，比不断go install省事
真正卡住人的从来不是“怎么装”，而是 go env 输出里那些看似无关的路径、go.mod 里一行 replace 的位置、或者 dlv 启动时少传的那个 --api-version 2。这些细节不报错，但会让调试器连不上、断点不命中、甚至 go run 突然找不到包。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
