go mod init 后提示“cannot find main module”是因为未在项目根目录执行或go.mod未生效；需确保在含.go文件的最外层目录运行go mod init example.com/myapp，并用go list -m验证模块加载。
go mod init 之后为什么 still no module found
执行 go mod init 后提示 go: cannot find main module，不是命令没跑成功，而是当前目录不在模块根路径下或未触发模块识别逻辑。
常见错误现象：
- 在子目录（如
src/myapp/）里执行go mod init，但go工具默认只认当前目录为模块根，不向上搜索 - 目录里已有
go.mod，但内容为空或格式非法（比如用了中文引号、缩进错乱） - 父目录存在另一个
go.mod，导致当前路径被判定为子模块，而你又没用replace或require显式声明它
实操建议：
- 确保在项目最外层目录（即你想设为模块根的目录）执行
go mod init example.com/myapp，不要进cmd/或internal/子目录再 init - 初始化后立刻运行
go list -m确认模块名是否已加载；若输出空行，说明模块未生效，检查go.mod是否真实写入磁盘且无 BOM - Windows 上用 PowerShell 创建文件时容易带 UTF-8 BOM，可用
Get-Content go.mod | Set-Content go.mod -Encoding UTF8NoBOM清除
GOROOT 和 GOPATH 还需要手动设吗
Go 1.16+ 默认启用模块模式（GO111MODULE=on），GOROOT 仍需存在（指向 Go 安装目录），但 GOBIN 和 GOPATH 已非必需——除非你明确要复用旧工作流或调试工具链本身。
使用场景：
-
GOROOT：必须，go命令靠它定位标准库和pkg目录；官方安装包会自动设好，手动解压二进制包则需用go env -w GOROOT="C:\Program Files\Go"补上 -
GOBIN：仅当你想把go install编译出的二进制统一放某处（如%USERPROFILE%\bin）才设；否则默认走$GOPATH/bin或$HOME/go/bin -
PATH中必须包含$GOBIN或$HOME/go/bin，否则go install出的命令无法全局调用
容易踩的坑：
- PowerShell 的
$env:GOPATH设置后不重启终端不会生效，且go env -w写的是 JSON 配置文件，与 shell 变量无关，二者别混用 - Chocolatey 安装的 Go 默认不创建
$HOME/go目录结构，go mod download会自动建pkg，但src和bin得自己mkdir
go get 为什么总卡在 golang.org/x/...
这不是网络问题，而是 Go 模块代理机制没生效。自 Go 1.13 起，默认启用 proxy.golang.org，但国内访问常被阻断，且该代理不缓存 golang.org/x/... 下的部分仓库（如 x/tools），导致回源失败。
实操建议：
- 优先设国内镜像代理：
go env -w GOPROXY=https://goproxy.cn,direct（direct表示对私有模块直连，不走代理） - 若公司内网有私有模块，加
NO_PROXY：go env -w GOPRIVATE=git.internal.company.com/* - 避免用
go get -u升级整个依赖树——它会递归拉取所有间接依赖，极易触发代理超时；改用go get example.com/pkg@v1.2.3精确指定版本
性能影响：
- 未设代理时，
go get会逐个尝试golang.org、github.com等源，每个失败都等 10 秒以上，整条命令可能卡数分钟 - 设了
goproxy.cn后，首次下载仍略慢（因要缓存），但后续复用极快，且支持校验和验证（sum.golang.org镜像也同步）
VS Code 调试器启动失败：exec: "dlv": executable file not found
这是 Delve（Go 调试器）没装或没进 PATH，不是 VS Code 插件问题。Go 扩展只是调用命令行工具，它不自带 dlv。
实操建议：
- 用
go install github.com/go-delve/delve/cmd/dlv@latest安装；注意别漏掉@latest，否则 Go 1.21+ 会报no required module provides package - 安装后确认
dlv在$GOBIN或$HOME/go/bin下，且该路径已加入PATH；PowerShell 中用$env:PATH += ";$HOME\go\bin"临时追加 - VS Code 的
launch.json不用改dlvPath，只要dlv可执行就行；若仍报错，关掉所有 VS Code 窗口重开，让插件重新探测环境
容易忽略的点：
-
dlv是 Go 编写的，它依赖当前GOROOT和GOOS/GOARCH；在 WSL 里装的dlv不能直接给 Windows 版 VS Code 用 - 某些杀软（尤其是 Windows Defender）会拦截刚编译的
dlv，首次运行前右键属性 → “解除锁定”
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
