VSCode调试Go文件报错：当前工作区未找到模块（Go v1.20.3）

错误原因 #

Go 1.16及以后版本默认启用模块模式，你的项目根目录没有初始化Go模块（缺少go.mod文件），导致go build命令无法识别项目结构，从而抛出该错误。

解决步骤 #

1. 初始化Go模块
   打开终端，切换到你的项目根目录（C:\Users\Shawn\go\vsCodeExam），执行以下命令：

   go mod init vsCodeExam
   

   （vsCodeExam可替换为你自定义的模块名称，比如你的项目名）
   执行后会在根目录生成go.mod文件，Go会以此识别项目的模块结构。

2. 调整调试配置（按需选择）

   • 若要调试当前打开的单个.go文件，将launch.json中的program字段设为：

     "program": "${file}"
     

   • 若要调试整个模块，确保项目根目录下有main包的入口文件（比如main.go），此时"program": "${workspaceRoot}"配置有效，但需先完成模块初始化。

3. 重新启动调试
   完成上述操作后，按F5重新启动调试，即可正常编译并进入调试流程。

补充说明 #

• 若你的项目依赖传统GOPATH模式（不使用模块），可通过设置环境变量GO111MODULE=off关闭模块模式，但推荐使用Go模块管理项目依赖与结构。
• 确保VSCode的Go插件已更新至最新版本，避免插件兼容性问题。

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