Go模块依赖列表异常：导入根模块无法正常列出依赖

从你描述的情况来看，核心问题在于**github.com/dinedal/textql这个模块的根目录并不是一个有效的Go包**，导致Go无法识别它，进而无法正常列出依赖。

问题原因解析 #

Go模块和Go包是两个不同的概念：

• 模块是由go.mod定义的代码集合，它可以包含多个子包；
• 包是由一个目录下的Go源码文件组成的，一个目录只有存在非测试类的.go文件时，才会被Go识别为一个有效包。

你遇到的错误提示：

go: finding module for package github.com/dinedal/textql module github.com/dinedal/textql@latest found (v0.0.0-20200608170856-250cf763f52c), but does not contain package github.com/dinedal/textql

意思很明确：Go找到了这个模块，但模块的根目录下没有任何Go源码文件，所以不存在github.com/dinedal/textql这个包。而子包github.com/dinedal/textql/storage目录下有Go文件，所以能被正常识别，依赖也能正确列出。

解决方案 #

根据你的实际需求，有两种处理方式：

1. 不需要根目录作为包使用

如果你的代码不需要导入github.com/dinedal/textql根路径，只用到子包的话，直接针对子包执行依赖查询命令即可：

go list -deps github.com/dinedal/textql/storage
# 或者查看模块依赖图谱
go mod graph | grep github.com/dinedal/textql/storage

这样就能正常获取子包的完整依赖列表了。

2. 需要根目录作为包使用

如果你确实需要把根目录作为一个包（比如要导出根包级别的API，或者它是命令行工具的入口），只需要在模块根目录下添加至少一个Go源码文件即可，比如创建一个textql.go文件，内容可以非常简单：

package textql

// 这里可以添加包级注释或后续需要导出的符号

如果是命令行工具，也可以创建main.go作为入口：

package main

func main() {
    // 你的命令行入口逻辑
}

添加之后，Go就会把github.com/dinedal/textql识别为一个有效包，此时再执行go list -deps github.com/dinedal/textql就能正常列出依赖了。

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