VSCode中Go语言服务导入包报错：当前文件不在工作区模块内

问题描述 #

在VSCode中打开项目时，所有第三方包及项目内部包导入均出现以下错误：

could not import github.com/gorilla/mux (current file is not included in a workspace module)compilerBrokenImport

项目目录结构 #

.
├── Makefile
├── README.md
├── api
│   ├── CHANGELOG.adoc
│   ├── Makefile
│   ├── README.md
│   ├── cmd
│   ├── cover.out
│   ├── dev
│   ├── docs
│   ├── env.sample
│   ├── go.mod
│   ├── go.sum
│   ├── groupsyncd
│   ├── iamd
│   ├── idmd
│   ├── internal
│   ├── mocks
│   ├── sonar-project.properties
│   ├── userlockd
│   └── vulnerability-suppression.xml
├── api-qa
│   ├── README.md
│   ├── pom.xml
│   ├── src
│   └── target
├── bin
│   └── entrypoint.sh
├── compose
│   ├── iam.yml
│   ├── idm.yml
│   ├── keycloak.yml
│   ├── localstack.yml
│   ├── mongodb.yml
│   └── mysql.yml
├── dev
│   ├── bundle.tar.gz
│   ├── context.tar.gz
│   ├── example.rego
│   ├── export-realm
│   ├── get-access-token
│   ├── idm-permissions.gz
│   ├── init
│   ├── jsonserver
│   ├── localstack
│   ├── mongodb
│   ├── nginx.conf
│   ├── setup-protocol-mapper
│   └── test-realm.json
├── docker-compose.yml
├── dockerfiles
│   ├── iam-api
│   ├── idm-api
│   ├── idm-energon
│   ├── idm-groupsync
│   ├── idm-userlock
│   ├── jsonserver
│   └── mongodb
├── env.sample
├── go.work
└── protos
    ├── commons
    └── energon.proto

Go工作区配置 #

根目录下go.work内容：

go 1.20

use ./api

Go环境变量 #

根目录执行go env输出 #

GO111MODULE=""
GOARCH="amd64"
GOBIN=""
GOCACHE="/Users/avlachopoulos/Library/Caches/go-build"
GOENV="/Users/avlachopoulos/Library/Application Support/go/env"
GOEXE=""
GOEXPERIMENT=""
GOFLAGS=""
GOHOSTARCH="amd64"
GOHOSTOS="darwin"
GOINSECURE=""
GOMODCACHE="/Users/avlachopoulos/.gvm/pkgsets/go1.20/global/pkg/mod"
GONOPROXY=""
GONOSUMDB=""
GOOS="darwin"
GOPATH="/Users/avlachopoulos/.gvm/pkgsets/go1.20/global"
GOPRIVATE=""
GOPROXY="https://proxy.golang.org,direct"
GOROOT="/Users/avlachopoulos/.gvm/gos/go1.20"
GOSUMDB="sum.golang.org"
GOTMPDIR=""
GOTOOLDIR="/Users/avlachopoulos/.gvm/gos/go1.20/pkg/tool/darwin_amd64"
GOVCS=""
GOVERSION="go1.20"
GCCGO="gccgo"
GOAMD64="v1"
AR="ar"
CC="clang"
CXX="clang++"
CGO_ENABLED="1"
GOMOD="/Users/avlachopoulos/go.mod"
GOWORK="/Users/avlachopoulos/development/ocp-iam/idm/go.work"
CGO_CFLAGS="-O2 -g"
CGO_CPPFLAGS=""
CGO_CXXFLAGS="-O2 -g"
CGO_FFLAGS="-O2 -g"
CGO_LDFLAGS="-O2 -g"
PKG_CONFIG="pkg-config"
GOGCCFLAGS="-fPIC -arch x86_64 -m64 -pthread -fno-caret-diagnostics -Qunused-arguments -fmessage-length=0 -fdebug-prefix-map=/var/folders/sw/lsrfw_3d537_w16x9cw3yynj7kg71v/T/go-build2156756382=/tmp/go-build -gno-record-gcc-switches -fno-common"

api模块目录执行go env输出 #

GO111MODULE=""
GOARCH="amd64"
GOBIN=""
GOCACHE="/Users/avlachopoulos/Library/Caches/go-build"
GOENV="/Users/avlachopoulos/Library/Application Support/go/env"
GOEXE=""
GOEXPERIMENT=""
GOFLAGS=""
GOHOSTARCH="amd64"
GOHOSTOS="darwin"
GOINSECURE=""
GOMODCACHE="/Users/avlachopoulos/.gvm/pkgsets/go1.20/global/pkg/mod"
GONOPROXY=""
GONOSUMDB=""
GOOS="darwin"
GOPATH="/Users/avlachopoulos/.gvm/pkgsets/go1.20/global"
GOPRIVATE=""
GOPROXY="https://proxy.golang.org,direct"
GOROOT="/Users/avlachopoulos/.gvm/gos/go1.20"
GOSUMDB="sum.golang.org"
GOTMPDIR=""
GOTOOLDIR="/Users/avlachopoulos/.gvm/gos/go1.20/pkg/tool/darwin_amd64"
GOVCS=""
GOVERSION="go1.20"
GCCGO="gccgo"
GOAMD64="v1"
AR="ar"
CC="clang"
CXX="clang++"
CGO_ENABLED="1"
GOMOD="/Users/avlachopoulos/development/ocp-iam/idm/api/go.mod"
GOWORK="/Users/avlachopoulos/development/ocp-iam/idm/go.work"
CGO_CFLAGS="-O2 -g"
CGO_CPPFLAGS=""
CGO_CXXFLAGS="-O2 -g"
CGO_FFLAGS="-O2 -g"
CGO_LDFLAGS="-O2 -g"
PKG_CONFIG="pkg-config"
GOGCCFLAGS="-fPIC -arch x86_64 -m64 -pthread -fno-caret-diagnostics -Qunused-arguments -fmessage-length=0 -fdebug-prefix-map=/var/folders/sw/lsrfw_3d537_w16x9cw3yynj7kg71v/T/go-build903840586=/tmp/go-build -gno-record-gcc-switches -fno-common"

补充说明 #

启用语言服务器前一切正常，目前环境配置已陷入困境，寻求解决方法。

解决方法 #

1. 确认VSCode工作区根目录 #

关闭VSCode，重新打开项目根目录（包含go.work的/Users/avlachopoulos/development/ocp-iam/idm），避免打开子目录导致工作区识别错误。

2. 修复模块关联异常 #

从根目录go env输出可见GOMOD指向用户根目录下的无关go.mod，执行以下命令重置工作区模块关联：

cd /Users/avlachopoulos/development/ocp-iam/idm
go work use ./api

3. 配置VSCode Go插件 #

打开VSCode设置（快捷键Cmd+,），确保：

• go.gopath设为/Users/avlachopoulos/.gvm/pkgsets/go1.20/global（与go env的GOPATH一致）
• go.workspaceFolder设为项目根目录路径/Users/avlachopoulos/development/ocp-iam/idm
• 保持go.useLanguageServer为启用状态

4. 清理并重新加载工作区 #

打开VSCode命令面板（快捷键Cmd+Shift+P），依次执行：

• Go: Clean Module Cache
• Go: Reload Workspace

5. 验证依赖完整性 #

切换到api目录执行：

go mod tidy

确保所有依赖正确下载后，回到VSCode检查导入错误是否消失。

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