本文介绍如何在使用 gb 构建工具的 Go 项目中正确组织本地包、配置 VS Code 实现跨包导入与智能提示，解决 cmd/model 等相对路径导入失败、gocode 无法识别等问题。

本文介绍如何在使用 gb 构建工具的 go 项目中正确组织本地包、配置 vs code 实现跨包导入与智能提示，解决 `cmd/model` 等相对路径导入失败、gocode 无法识别等问题。

gb（Go Build）是一个面向“项目工作区”的构建工具，它不依赖 GOPATH，而是以当前目录为根（即 project root），要求所有源码严格置于 src/ 下，并通过完整、绝对的 import path 引用包——这个路径必须与 src/ 下的目录结构完全一致，且不能是相对路径或简写。

在你的项目结构中：

src/
├── cmd/
│   ├── model/
│   │   └── calc.go   # package model
│   └── server/
│       └── server.go # package main

你当前的导入语句 "cmd/model" 是错误的，因为 gb 要求 import path 必须从 src/ 开始，省略 src/ 前缀后，剩余路径即为合法 import path。因此，src/cmd/model/ 对应的正确 import path 是 "cmd/model" —— 这本身没错，但问题出在两个关键环节：

✅ 正确做法：规范包路径 + 配置 gb 工作区

1. 确保 src/ 是项目根目录：执行 gb build all 时，当前工作目录必须是包含 src/ 的父目录（即 gb 项目的根）。

2. cmd/model 是合法路径，但需满足：

   • src/cmd/model/calc.go 中必须声明 package model（你已做到）；

     

     VS Code Node

     通过作为 OpenClaw 节点连接的 VS Code/Cursor IDE 操作代码，提供 40 多种命令，涵盖文件操作、语言智能、Git、测试等功能。

     下载

   • src/cmd/server/server.go 中应写为：

     package main
     
     import (
         "cmd/model" // ✅ 正确：对应 src/cmd/model/
         "fmt"
     )
     
     func main() {
         fmt.Println(model.Add(1, 2))
     }

3. gb 会自动识别 src/ 下所有包，无需额外注册 —— 只要路径存在且包名合法，gb build cmd/server 即可成功。

⚠️ VS Code 配置要点（核心修复）

VS Code 的 Go 扩展（如 gopls 或旧版 go-plus）默认依赖 GOPATH 或 GOROOT 解析符号，而 gb 项目是独立工作区。因此需显式告知其项目根路径：

• 在项目根目录下创建 .vscode/settings.json：

  {
    "go.gopath": "${workspaceFolder}",
    "go.toolsEnvVars": {
      "GB_PROJECT_DIR": "${workspaceFolder}"
    },
    "go.useLanguageServer": true,
    "go.languageServerFlags": ["-rpc.trace"]
  }

  ? 关键说明：

  • "go.gopath": "${workspaceFolder}" 并非将项目当 GOPATH（gb 不需要），而是让 gopls 将此目录视为模块根进行符号索引；
  • GB_PROJECT_DIR 环境变量显式声明给 gb 工具链（部分插件会读取）；
  • 启用 gopls（推荐）而非 gocode，因其对多模块/非-GOPATH 项目支持更佳。

? 验证与调试步骤

1. 终端进入项目根目录（含 src/），运行：

   gb build cmd/server
   # 应成功生成 bin/server

2. 在 VS Code 中按 Ctrl+Click（或 Cmd+Click）点击 "cmd/model"，应跳转至 src/cmd/model/calc.go；
3. 输入 model. 后应出现 Add 的自动补全。

❌ 常见误区提醒

• import "./model" 或 "model" 是无效的 —— gb 不支持相对导入或短路径；
• 不要将 src/cmd/model 移到 src/model 下再导入 "model"：这会破坏 gb 的包发现逻辑（gb 仅扫描 src/ 下所有子目录，但路径即 import path）；
• 避免混用 go build 和 gb：二者工作模式冲突，会导致 VS Code 符号解析混乱。

✅ 最佳实践总结

项目要素	推荐方式
目录结构	src/cmd/model/, src/cmd/server/
import path	"cmd/model"（严格匹配 src/ 下路径）
VS Code 配置	go.gopath 指向 workspace 根 + 启用 gopls
第三方依赖	gb vendor fetch github.com/user/pkg → 自动存入 vendor/，导入时仍用 "github.com/user/pkg"

遵循以上结构与配置，即可在 gb 项目中无缝使用本地包与第三方依赖，同时获得完整的编辑器支持。