go mod init 报“no such file or directory”是因为当前目录无 .go 文件，需先创建 main.go（含 package main 和 func main()），再执行 go mod init example.com/myapp；vs code 调试报 “dlv: command not found” 则需手动运行 go install github.com/go-delve/delve/cmd/dlv@latest 并重启编辑器。
不需要手动配 GOPATH，也不用纠结 GOROOT 是否写错——现代 Go（1.16+）默认启用 module 模式，只要装好 Go 二进制、设好代理、初始化 go.mod，VS Code 就能直接调试。
go version 能跑，但 go mod init 报错：no such file or directory
这是 Windows 或 macOS 用户在新建空文件夹后直接运行 go mod init 的典型现象。Go 要求当前目录下至少有一个 .go 文件（哪怕只是空的），否则会找不到主模块根路径。
- 先创建一个
main.go，内容可以极简：package main func main() {} - 再执行
go mod init example.com/myapp（域名部分可随意，不需真实存在） - 如果仍报错，检查当前 shell 是否在正确目录：用
pwd（macOS/Linux）或cd（Windows）确认路径，别误入父级或桌面根目录
VS Code 点 F5 提示 “dlv: command not found”
这不是插件没装好，而是 Delve 调试器没装进系统 PATH。VS Code 的 Go 插件会尝试自动安装，但常因网络失败静默退出。
- 手动安装：终端运行
go install github.com/go-delve/delve/cmd/dlv@latest - 验证是否成功：运行
dlv version，有输出即表示已就位 - 关键点：安装后必须重启 VS Code（不是重载窗口），否则插件读不到新命令
- 若提示
cannot find package，说明 GOPROXY 没生效，先运行go env -w GOPROXY=https://goproxy.cn,direct
launch.json 里 program 字段填什么才不报错
填 ${workspaceFolder} 最稳妥，但仅限项目根目录下有且仅有一个 main.go 或 cmd/ 子目录结构。一旦项目变复杂，这里就容易翻车。
- 单文件项目（如
main.go在根目录）：用${workspaceFolder} - 多命令项目（如
cmd/api/main.go和cmd/cli/main.go）：必须指定具体路径，例如${workspaceFolder}/cmd/api - 绝对不能填
./main.go—— Delve 不支持直接调试源文件，只接受包路径或目录 - 如果改了
program还报 “no main package”，检查对应目录下是否有package main且无语法错误
断点打了，F5 启动却直接跑完没停
常见于 Windows 上用 PowerShell 启动调试时，或 launch.json 的 mode 配置为 test 却想调试主程序。
- 确认
launch.json中"mode": "auto"或"mode": "exec"，别写成"test"或漏掉该字段 - 检查断点行是否可执行：空行、注释、函数签名、
import行都不能设断点 - PowerShell 用户注意：VS Code 默认用它做终端，但某些旧版插件对 PS 的调试钩子支持不稳定；临时切到 Command Prompt 或 Git Bash 再试一次
- 最隐蔽的坑：代码里用了
os.Exit(0)或 panic 前的逻辑过快，导致断点还没命中就退出——加一行time.Sleep(time.Second)拉长执行窗口便于观察
module 初始化和 dlv 安装是两个真正卡住人的节点，其他问题大多绕不开这两个动作是否干净完成。代理没设、PATH 没刷新、编辑器没重启，三者任一缺失都会让调试流程中断在看似无关的环节。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
