Windows10下VSCode调试Go1.21.1项目报错，求解决方法

问题背景 #

环境信息：

• 平台：Windows 10
• Golang版本：go1.21.1 windows/amd64
• Delve版本：1.21.1

VSCode的launch.json配置：

"version": "0.2.0",
"configurations": [
    {
        "name": "Launch Package",
        "type": "go",
        "request": "launch",
        "mode": "debug",
        "program": "${fileDirname}"
    }
]

调试时出现错误：

DAP server listening at: 127.0.0.1:48323
Build Error: go build -o xxxx\project\rpc\client\src__debug_bin3964848569.exe -gcflags all=-N -l .
client.go:4:2: package fmt is not in std (C:\Users\Admin\go\src\fmt)
client.go:5:2: package net/rpc is not in std (C:\Users\Admin\go\src\net\rpc)
package rpc/client/src: cannot find package (exit status 1)

项目可正常构建，但调试失败。

解决步骤 #

1. 确保项目启用Go Modules #

• 检查项目根目录是否存在go.mod文件，没有的话打开终端切换到项目根目录执行：

  go mod init 你的项目模块名
  

  比如项目路径是xxxx\project\rpc\client，可执行go mod init rpc/client
• 打开VSCode命令面板（Ctrl+Shift+P），输入Go: Reload Workspace，让插件重新识别模块配置

2. 修正launch.json配置 #

调试失败的核心是路径或环境变量配置错误，导致调试器用了错误的模块模式：

• 将program字段改为项目包的工作区相对路径，比如：

  "program": "${workspaceFolder}/rpc/client/src"
  

• 添加env字段强制启用模块模式

修改后的完整launch.json示例：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Launch Package",
            "type": "go",
            "request": "launch",
            "mode": "debug",
            "program": "${workspaceFolder}/rpc/client/src",
            "env": {
                "GO111MODULE": "on"
            }
        }
    ]
}

3. 检查VSCode Go插件设置 #

• 打开VSCode设置（Ctrl+,），搜索Go: Gopath，确保路径正确，或留空让Go自动识别（Go 1.14+支持自动处理）
• 搜索Go: Use Modules，确保勾选该选项，强制插件使用模块模式

4. 清理缓存并重启 #

• 删除调试生成的临时可执行文件（错误提示中的src__debug_binxxxx.exe）
• 重启VSCode后重新尝试调试

原因说明 #

正常构建时你应该是在项目根目录执行go build，此时Go自动启用模块模式，从模块缓存（%GOPATH%\pkg\mod）加载标准库和依赖；但调试时VSCode配置未正确识别工作区，默认使用旧的GOPATH模式，错误地去用户的C:\Users\Admin\go\src目录找标准库，而该目录下没有官方标准库文件，因此报错。

内容的提问来源于stack exchange，提问作者eric