如何让VSCode Go插件在多模块仓库中正常工作

问题根因：VSCode 默认的Go扩展（依赖gopls语言服务器）只会识别工作区根目录下的go.mod，嵌套的独立Go项目自带独立go.mod，属于不同模块，默认不会被加载识别，以下是三种可行的解决方法：

方法1：使用VSCode多根工作区（最推荐，无需修改项目结构） #

• 打开主Go项目的根目录
• 点击顶部菜单栏 文件 > 将文件夹添加到工作区，选择嵌套独立Go项目的根目录（即嵌套项目go.mod所在的目录）
• 点击 文件 > 将工作区另存为，将配置存为后缀为.code-workspace的文件，后续直接打开该文件即可同时加载两个项目
• 按下Ctrl+Shift+P（Mac端为Cmd+Shift+P），输入 Go: Restart Language Server 执行重启，重启后gopls会同时识别两个独立go.mod模块，代码提示、跳转、语法检查均可正常工作

方法2：配置gopls目录识别规则 #

如果不想使用多根工作区，可以直接修改工作区配置指定要识别的模块目录：

• 按下Ctrl+Shift+P，输入 Preferences: Open Workspace Settings (JSON) 打开工作区配置文件
• 添加如下配置：

{
  "gopls": {
    "build.directoryFilters": [
      "+嵌套项目的相对路径",
      // 示例：如果嵌套项目存在主项目的subapp目录下，就填写 "+subapp"
      "-不需要识别的无关目录"
    ]
  }
}

• 保存配置后重启Go语言服务器即可生效

方法3：使用Go官方工作区特性（Go 1.18+版本支持） #

如果本地Go版本在1.18及以上，可以直接用原生Go工作区能力，不需要修改VSCode配置：

• 在主项目根目录下执行命令：
  go work init ./ ./嵌套项目的相对路径
• 执行完成后主项目根目录会生成go.work文件，gopls会自动识别该文件内列出的所有模块，所有项目的语法能力均可正常使用

注意：go.work属于本地开发配置，不需要提交到Git仓库，建议添加到.gitignore中避免影响其他开发者

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