Go项目跨目录导入utility包报错，求问题排查与解决

你的导入错误核心原因是包路径和实际目录结构不匹配，结合你的描述和配置，按以下步骤排查修复：

1. 修正目录结构（最可能的问题） #

你提到utility.go直接放在services目录下，但你导入的路径是github-app/services/utility——这个路径对应的是services/utility子目录，而非services目录本身。

Go的包导入路径基于目录层级而非包名，规范的做法是：

• 在services目录下创建utility子目录，将utility.go移入该子目录
• 保持utility.go里的package utility声明不变

调整后目录结构如下：

github-app/
  go.mod
  github_events.go
  services/
    utility/
      utility.go

此时导入路径github-app/services/utility与目录结构完全匹配，报错会自动消失。

2. 若不想调整目录结构（不推荐） #

如果坚持把utility.go放在services目录下，它的包路径应为github-app/services，而非github-app/services/utility，此时导入方式需修改为：

import (
  // 其他导入项...
  utility "github-app/services"
)

这种方式用别名utility对应services目录下的utility包，但目录名与包名不一致会增加维护混乱，不推荐使用。

3. 确保模块正确初始化 #

确认go.mod文件在github-app根目录下，且在根目录执行过以下命令：

go mod tidy

该命令会让Go模块自动识别项目内所有包，更新依赖索引。

4. 刷新IDE缓存 #

若以上操作后IDE仍报错，大概率是缓存问题：

• VS Code：打开命令面板（Ctrl+Shift+P），执行Go: Reload Workspace
• GoLand：点击菜单栏File -> Invalidate Caches...，选择清除缓存并重启

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