go环境配置失败主因是goroot/gopath路径错误或代理未设；net/http服务编译失败多因模块未初始化或go build路径指定不当；go version报错需检查path和goroot；go111module必须设为on；国内需配置goproxy；交叉编译须临时设置goos/goarch；vs code调试应使用dlv debug而非go run。
Go 环境装不起来，八成卡在 GOROOT 和 GOPATH 的路径配置或代理设置上；写完 net/http 服务却编译不出可执行文件，大概率是没理解 go build 的默认行为或模块初始化缺失。
go version 和 go env 输出异常怎么办
常见现象：运行 go version 报错 command not found，或 go env 显示 GOROOT 为空、GOPATH 指向错误路径、GO111MODULE 是 auto 而非 on。
- 先确认
/usr/local/go/bin（Linux/macOS）或C:\Program Files\Go\bin（Windows）是否真被加进PATH—— 在终端里直接运行/usr/local/go/bin/go version，能输出就是路径没生效 -
GOROOT一般不用手动设，除非你解压到了非标准位置；若手动设了，必须指向包含bin、pkg、src的根目录，比如/usr/local/go，而不是/usr/local/go/bin -
GO111MODULE=on必须显式开启：运行go env -w GO111MODULE=on，否则go mod init不生效，依赖会乱扔进GOPATH/src - 国内用户务必配代理：
go env -w GOPROXY=https://goproxy.cn,direct，否则go get或go mod download会卡死或超时
用 net/http 写的服务为什么 go run 能跑，go build 却失败
根本原因不是代码问题，而是构建上下文缺失 —— go build 默认只编译当前目录下的 .go 文件，且要求模块初始化完整。
- 确保项目根目录有
go.mod文件：没有就先go mod init example.com/myserver，模块名不必真实可访问，但不能含空格或大写字母 - 如果入口文件不在当前目录（比如
cmd/server/main.go），必须指定路径：go build -o server cmd/server/main.go，不能只敲go build -
go run .会自动找main函数，但go build不会递归扫描子目录；多个main包共存时，必须明确指定目标文件 - 检查是否有未使用的导入（尤其是误引入的第三方包），
go build比go run更严格，会报imported and not used
交叉编译 Linux/ARM 二进制时 GOOS GOARCH 设不生效
环境变量必须在 go build 命令前临时设置，或用 env 显式传入；写进 shell 配置文件里反而容易污染本地开发环境。
- 正确写法：
GOOS=linux GOARCH=arm64 go build -o myapp-linux-arm64 . - 错误写法：
export GOOS=linux; export GOARCH=arm64; go build .—— 这会让后续所有go命令都按该平台编译，包括go run，极易出错 - Windows 上用 PowerShell 要写成：
$env:GOOS="linux"; $env:GOARCH="amd64"; go build -o app.exe . - ARM 编译需注意：Go 官方镜像支持
arm64，但不支持arm（32位）；若目标设备是树莓派 Zero，得用 Go 1.20 以前版本或换交叉工具链
vscode 调试 http.Server 时无法热重载或断点不命中
VS Code 的 Go 扩展默认用 dlv 调试，但它不支持监听文件变更自动重启 —— 这不是 bug，是设计如此；断点失效则多因工作区路径或模块名不匹配。
- 别依赖
go run+ 断点：改用dlv debug启动，它会自动 rebuild 并 attach，命令是dlv debug --headless --listen :2345 --api-version 2 --accept-multiclient - 确保
launch.json中的program字段指向正确入口，比如"${workspaceFolder}/cmd/server/main.go"，而不是"${workspaceFolder}" - 如果用了
go.work多模块工作区，VS Code 可能加载错模块根目录，此时手动在 VS Code 窗口右下角点击 Go 状态栏，选对当前模块 - HTTP 服务启动后立刻退出？检查
http.ListenAndServe是否被log.Fatal包裹 ——log.Fatal会 os.Exit(1)，调试器来不及响应
真正卡住人的从来不是语法，而是 go mod 初始化时机、GOOS/GOARCH 的作用域、以及调试器和构建命令之间那层隐式约定 —— 这些地方没显式声明，就默认按最保守方式处理。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
