Go本地模块导入报错：已执行go mod命令仍无法解决

核心排查步骤 #

• 检查目录结构是否匹配模块名
  你的模块名是go_backtest，存放go.mod的项目根目录结构必须和导入路径严格对应：

  go_backtest/
    go.mod
    main.go  # 你的主程序文件
    strategies/
      xxx.go  # 包声明为package strategies
    utils/
      yyy.go  # 包声明为package utils
      # 若有子目录如utils/helpers，导入路径需写go_backtest/utils/helpers
  

  注意：utils目录不能为空，必须包含至少一个.go文件。

• 核对导入语句的正确性
  导入本地包必须使用模块名开头的完整路径，比如导入utils包要写：

  import "go_backtest/utils"
  

  不要用./utils这类相对路径，模块模式下Go优先识别模块路径。

• 检查包声明是否一致
  utils目录下所有.go文件的第一行，包声明必须是package utils，如果写成package util或其他名称，会直接导致导入失败。

• 重新执行模块命令
  确保在项目根目录下执行：

  go mod tidy
  

  该命令会自动扫描所有导入的包并生成正确的依赖记录，本地包只要路径正确就会被识别，无需上传到GitHub。

• 处理IDE缓存问题
  如果代码能正常编译但IDE仍显示红色下划线：

  • 直接重启IDE
  • 以VSCode为例，按Ctrl+Shift+P，搜索并执行Go: Reload Workspace

为什么strategies正常而utils报错？ #

大概率是utils的目录结构、包名或导入路径存在问题：比如utils目录不存在、目录内无.go文件、包名拼写错误，或者导入时路径写错（比如把utils写成util）。

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