执行go mod tidy提示"all" matched no packages是什么原因

警告含义 #

这个警告的核心逻辑是：执行go mod tidy时，Go工具链在当前模块的根目录下，没有扫描到任何符合构建条件、语法合法的Go源码包，因此无法解析代码中的import依赖关系，自然也不会自动拉取你引用的第三方包。
正常流程下go mod tidy会扫描当前模块下所有Go源码的导入语句，自动下载缺失依赖、移除未使用的依赖，一旦扫不到任何有效源码，就会返回该提示。

常见触发原因 #

已经创建了main.go但仍触发警告，基本是以下几个问题导致的：

• 文件路径错误：执行vim main.go时当前工作目录不对，文件被保存到了其他路径，执行go mod tidy的模块根目录下实际不存在.go后缀的源码文件
• 文件不合法：
  • 文件后缀错误，比如Windows下开启隐藏扩展名时，文件实际被存为main.go.txt，Go无法识别
  • 文件内语法错误，比如package声明拼写错误、被注释，或者import语句、函数结构有语法问题，Go解析源码失败
  • 文件开头添加了不匹配当前运行环境的构建约束（build tag），比如写了//go:build windows却在Linux/macOS下执行命令，Go会直接跳过该文件不纳入扫描范围

修复步骤 #

1. 先执行ls命令查看当前目录文件，确认你编辑的main.go确实存在于执行go mod init rtws的目录下，没有存错路径
2. 打开main.go确认基础结构合法，最简合法结构参考：

package main

import (
    "fmt"
    "github.com/gorilla/websocket"
)

func main() {
    fmt.Println("test")
    // 粘贴的示例业务逻辑
}

重点检查：首行package main无拼写错误、未被注释，import路径无拼写错误，文件无明显语法错误
3. 如果你是Windows系统，关闭资源管理器的「隐藏已知文件类型的扩展名」选项，确认文件后缀确实是.go而非其他格式
4. 检查文件开头是否有//go:build xxx格式的构建标签，确认标签规则匹配你当前的运行系统、架构
完成以上检查后，可以先执行go list ./...验证，如果命令能正常输出模块的包路径（比如会输出rtws），再重新执行go mod tidy，就不会再出现该警告，工具会自动下载github.com/gorilla/websocket依赖，后续即可正常运行程序。

内容的提问来源于stack exchange，提问作者James M. Lay