这是go 1.16+默认行为，不是错误；从go 1.16起模块模式默认启用，gopath不再强制要求，go env gopath可能为空或返回默认路径，项目依赖由go.mod管理，关键需确认go111module=on且goproxy生效。
go version 显示正常但 go env 里 GOPATH 是空的，怎么回事？
这是 Go 1.16+ 默认行为，不是错误。从 Go 1.16 开始，go mod 成为默认模式，GOPATH 不再强制要求，go env GOPATH 可能返回空或默认路径（如 C:\Users\用户名\go），但实际项目依赖完全由 go.mod 管理。
真正要关注的是：GO111MODULE 是否为 on，以及 GOPROXY 是否生效。执行以下命令确认：
go env -w GO111MODULE=on<br>go env -w GOPROXY=https://goproxy.cn,direct
- 如果
go mod download报错module lookup failed，大概率是代理没生效或网络不通 -
GOPATH为空不影响模块化开发，但若你用旧式src/pkg/bin结构（比如手动放第三方包到$GOPATH/src），就必须显式设置 - VS Code 的 Go 扩展会自动 fallback 到默认
GOPATH，无需手动干预，除非你明确要用自定义路径存放工具二进制（如gopls）
GOOS=windows GOARCH=arm64 编译失败，提示 “no such file or directory”
这不是代码问题，而是 Go 工具链本身不支持在非 Windows 主机上交叉编译 Windows ARM64 —— Go 官方只提供 GOOS=windows 的预编译二进制，且仅限 amd64 架构。想生成 Windows ARM64 可执行文件，必须在 Windows 主机上编译，或使用 Windows + WSL2 + Docker 模拟环境。
- Linux/macOS 上执行
GOOS=windows GOARCH=arm64 go build会直接报错，因为go二进制里根本没有对应目标平台的链接器和标准库 - 可行替代方案：用 GitHub Actions 的
windows-latestrunner，或本地 Hyper-V/Parallels 跑 Windows VM，再 ssh 进去构建 - 若只是测试兼容性，可用
GOOS=linux GOARCH=arm64在 Linux 机器上验证逻辑，但不能替代真实 Windows ARM64 运行时行为
vscode-go 插件反复提示 “Failed to install tools”，点重试还是卡住
根本原因通常是 gopls 或 dlv 下载被墙，或 $GOPATH/bin 权限不足。不要无脑点“Install All”，先手动控制安装流程。
- 打开命令面板（
Ctrl+Shift+P），运行Go: Install/Update Tools，**取消勾选gopls和dlv**，只留goimports、gomodifytags等轻量工具，确保基础功能可用 - 单独安装
gopls：go install golang.org/x/tools/gopls@latest（前提是GOPROXY已设好） - 检查
$GOPATH/bin目录是否可写，Windows 上常见问题是该目录落在 OneDrive 同步区或权限受限的系统路径下 - VS Code 设置里关掉
"go.toolsManagement.autoUpdate": false，避免后台静默失败干扰
宝塔面板部署 Go Web 服务，反向代理后页面空白或 502
90% 是监听地址写成了 0.0.0.0:8080，而宝塔反向代理只认 127.0.0.1。Go 程序必须绑定到回环地址，否则宝塔无法建立连接。
- 启动代码里把
http.ListenAndServe(":8080", nil)改成http.ListenAndServe("127.0.0.1:8080", nil) - 确认服务已实际运行：
curl -v http://127.0.0.1:8080能返回内容，再查宝塔反向代理配置里的目标 URL 是否为http://127.0.0.1:8080（不能带https或域名） - nohup 启动时记得加
&，且日志重定向要完整：nohup /usr/local/go/bin/go run main.go > app.log 2>&1 & - 长期运行务必改用 systemd，否则 nohup 进程在 SSH 断开后可能被 SIGTERM 终止
跨平台编译和生产部署里最易忽略的，其实是监听地址和代理协议的匹配 —— 它不报错，但就是不工作，得一层层 curl 验证流量路径。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
