VSCode下Golang包引用异常、IntelliSense失效问题求助

两个异常属于同一根源问题：VSCode 调用的 Go 语言服务 gopls 未正确识别项目的 go.mod 模块根，运行在 GOPATH 模式而非 Go Modules 模式下。你贴的 go env 输出中 GOMOD="/dev/null" 就是直接证据——正常加载带 go.mod 的模块项目时，该字段应当指向项目根目录下 go.mod 的绝对路径，而非 /dev/null。

• 智能提示失效是必然结果：gopls 没有成功加载模块索引，自然无法提供本地包、第三方包的补全提示，你对IDE自动提示本地包的认知没有错误。
• 自动添加example别名不是配置项导致的，属于gopls异常时的错误行为：它没有正确解析导入路径对应的实际包名，错误将缓存/当前打开文件中识别到的example包名绑定到你手动写的导入路径上，才会生成多余的别名前缀。重启VSCode后gopls临时重新加载，异常会短暂消失，一旦服务索引再次错乱就会复现。

触发该问题最常见的原因是打开项目的方式错误：直接单独打开某个.go文件，而非从go.mod所在的根目录打开整个文件夹，导致gopls向上遍历目录时找不到go.mod文件，自动退出Modules模式。

按顺序操作即可解决：

1. 固定全局Go模块配置
   打开终端执行以下两条命令，强制开启Go Modules模式，同时替换可正常访问的模块代理（默认的proxy.golang.org国内网络环境下经常超时，会导致gopls拉取索引失败）：

   go env -w GO111MODULE=on
   go env -w GOPROXY=https://goproxy.cn,direct
   

   执行完成后运行go env确认两个参数已修改生效。
2. 修正VSCode项目打开方式
   不要直接单文件打开代码，通过VSCode的「打开文件夹」功能，选中存放go.mod的项目根目录（即你测试项目中包含main.go、go.mod、obs子目录的那一层）打开，确保gopls能准确定位到模块根。
3. 重置gopls状态
   按Cmd+Shift+P唤起命令面板，依次执行操作：
   • 输入Go: Restart Language Server回车，重启Go语言服务
   • 如果重启后仍有异常，再执行Go: Clean Module Cache清理模块缓存，之后重启VSCode即可。
4. 导包逻辑验证
   按照你提供的测试项目结构，obs目录下的example.go声明包名为example，对应导入路径github.com/foo/go/obs的默认引用名就是example，正常配置下你在main.go中输入example.Do()时，gopls会自动补全导入行，不会额外添加冗余的别名前缀。

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