Go 1.20工作区中模块名与包名是否存在关联？

核心结论 #

模块名与包名没有强制绑定关系，但导入路径的构成依赖模块名和包所在的目录结构，而非包名本身。你的错误是混淆了包名和导入路径的逻辑。

原理拆解 #

• 模块名：是go.mod中module声明的字符串，作为模块的全局唯一标识，用于依赖管理中定位模块。比如你的first模块名是firstmod.com/qwerty。
• 包名：是单个.go文件顶部package声明的名称，是代码中引用该包内标识符的本地名称。同一目录下的.go文件必须使用相同的包名。
• 导入路径规则：导入一个包时，路径格式为模块名/包的相对路径。如果包直接放在模块根目录下（与go.mod同目录），相对路径为空，导入路径就是模块名本身；如果包在模块内的子目录（如first/utils），则导入路径为firstmod.com/qwerty/utils，此时子目录下的包名可自行定义（只要目录内文件包名一致）。

你的错误分析 #

你将first.go的包名改为testpackage后，错误尝试导入firstmod.com/qwerty/testpackage，但该包仍在first模块的根目录下（与go.mod同目录），因此导入路径依然是firstmod.com/qwerty，变化的只是代码中引用该包的标识符（从qwerty改为testpackage）。

报错no required module provides package "firstmod.com/qwerty/testpackage"的原因是：Go在模块firstmod.com/qwerty中找不到testpackage子目录，无法定位对应的包。

修正方案 #

修改后的first.go #

// first.go
package testpackage

func FirstClass() int64 {
    return 1
}

修改后的main.go #

// main.go
package main

import (
    "fmt"
    "firstmod.com/qwerty" // 导入路径不变，仍为模块名
    "secmod.com/asdfg"
)

func main() {
    fmt.Println("Hiii")
    fmt.Println(asdfg.Second())
    fmt.Println(testpackage.FirstClass()) // 使用新包名调用函数
}

修改后代码即可正常运行。

补充说明 #

Go工作区（go.work）的作用是让本地多个模块可互相引用，无需发布到远程仓库，但模块的导入规则与普通依赖完全一致——工作区仅覆盖依赖的解析来源（从本地目录而非远程拉取），不会改变模块名、包名、导入路径之间的逻辑。

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