该错误源于同一目录下存在多个不同 package 声明，go 要求同目录所有 .go 文件必须属于同一包；需检查并统一 package 声明，或按规范将不同包拆至不同子目录，并确保 go.mod 位置及模块路径正确。
为什么会出现 “multiple packages in directory” 错误
这个错误不是包名冲突，而是 Go 编译器发现同一个目录下有多个 package 声明 —— 比如两个 .go 文件分别写了 package main 和 package utils。Go 要求**同一目录下的所有 Go 文件必须属于同一个包**，否则直接拒绝编译。
检查当前目录是否混用了不同 package 声明
运行 ls *.go 查看该目录下所有 Go 文件，再逐个用 head -n 1 *.go 看第一行 package xxx 是否一致。常见踩坑点：
- 把
main.go和utils.go放在同一目录，但一个写package main，另一个写package utils - 复制示例代码时漏删旧文件，残留了不同包名的测试文件
- IDE 自动生成了同名但不同包的文件（比如 Goland 有时会建错模板）
正确组织多包项目的目录结构
Go 不允许“一个目录多个包”，但支持“一个包多个文件”或“多个目录多个包”。要声明多个包，必须拆到不同子目录：
- 每个子目录对应一个包，目录名通常与
package名一致（如utils/下放package utils） -
main.go必须在单独目录（通常是项目根目录），且只能是package main - 导入时路径是模块路径 + 子目录名，例如
import "myproject/utils"，而非import "./utils"
go.mod 位置和模块路径必须匹配
如果报错同时伴随 no required module provides package，大概率是 go.mod 不在项目根目录，或 module 声明的路径和实际导入路径不一致。关键检查项：
-
go.mod必须和main.go在同一级目录 -
module行写的路径（如module example.com/myapp）要能覆盖所有子包路径，比如example.com/myapp/utils - 避免用相对路径或本地路径（如
./utils）作为导入路径，Go 不认这种写法
最常被忽略的是：错误提示看起来像包冲突，实际根源往往是目录结构违规或 go.mod 位置/内容错位。先确认单目录单包，再核对模块路径，比反复改包名更省时间。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
