Go项目导入本地example包失败：编译报错不在GOROOT/GOPATH

问题根源 #

核心问题是导入路径错误，加上模块模式未强制启用导致包查找逻辑混乱，另外SWIG生成的C++绑定包需要正确的CGO构建环境。

修复步骤 #

1. 强制启用Go模块模式 #

你的GO111MODULE为空，会让Go根据目录位置自动切换模式，容易引发问题。执行以下命令强制启用模块模式：

export GO111MODULE=on  # Linux/macOS环境
# Windows命令行执行：
# set GO111MODULE=on

2. 修正main.go的导入路径 #

你的go.mod模块名为my_project，example包是模块内的子包，正确导入路径应为模块名+包的相对路径。修改main.go的导入部分：

package main

import (
    "my_project/cmd/my_project/example"
    "fmt"
)

func main() {
    var p example.Person
    p.Dob = 20
    example.Handle(p)
}

3. 确保SWIG包能正确编译 #

example包包含C++文件，需要依赖系统的protobuf库和正确的CGO配置：

• 安装protobuf C++开发包（以Ubuntu为例）：

  sudo apt-get install libprotobuf-dev protobuf-compiler
  

• 在项目根目录单独构建example包，排查编译错误：

  go build ./cmd/my_project/example
  

4. 正确运行项目 #

必须在pet_project目录下（go.mod所在目录）执行命令：

go run ./cmd/my_project/main.go

5. 修复VS Code的识别问题 #

修改导入后，VS Code可能需要重新加载工作区：

• 按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）
• 执行Go: Reload Workspace命令

额外排查点 #

• 确认始终在pet_project目录下执行Go命令，Go会以此为模块根目录查找子包
• 检查example.go的包声明是否为package example（你已正确设置）

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