Go模块入门与实操疑问：go mod init命令简化解释及执行位置、命名规则咨询

我来帮你把这个问题掰扯清楚——当初我刚接触Go模块的时候也在这卡了好久，太懂这种困惑了！

先搞懂go mod init到底是干啥的 #

简单说，go mod init就是给你的Go项目办一张“专属身份证”，告诉Go工具链：“嘿，这是一个独立的模块项目，以后我导入自己的代码或者第三方依赖，都按这个模块的规则来！”

没有它的话，Go还是会默认启用旧的GOPATH模式，很容易出现依赖混乱、本地代码导不进来的问题，模块功能就是为了彻底解决这些痛点而生的。

你该在哪个目录执行go mod init？ #

看你的目录结构：

src
├── main
│   └── main.go
└── pkg
    └── pkg.go

答案是：必须在src目录下执行！

为啥？因为src是你整个模块的根目录——里面包含了这个模块下的所有代码（main包和pkg包）。如果在main或者pkg子文件夹下执行，Go会把那个子文件夹当成独立的模块根，另一个文件夹的代码就不在同一个模块体系里了，自然会出现导入失败的问题。

命名规则是什么？ #

go mod init后面跟的名字，其实是你的模块的唯一标识，就像身份证号，只要是合法的字符串就行，但通常有两种常用的命名方式：

• 如果这个项目以后要放到GitHub/GitLab这类代码托管平台，就用仓库地址命名，比如go mod init github.com/yourname/yourproject——这样别人克隆你的项目时，Go能自动识别并拉取正确的依赖路径。
• 如果只是本地测试用，随便起个合法的名字就行，比如go mod init mytestproject或者go mod init local/pkgdemo，没有强制要求，只要你自己能对应上导入路径就行。

针对你的目录结构的具体操作步骤 #

1. 打开终端，切换到src目录：

cd /你自己的src目录绝对路径/

2. 执行初始化命令，比如我给你起个本地测试用的名字：

go mod init local/demoproject

3. 修改代码里的导入路径：
   • 在main/main.go里，导入pkg包的时候要写成：import "local/demoproject/pkg"
   • （如果pkg包需要引用main包的内容，同样用这个模块名开头的路径，不过通常main包是程序入口，很少被其他包引用）
4. 执行go mod tidy，让Go自动整理模块依赖（哪怕没有第三方依赖，执行一下也能确保go.mod文件正常生成）：

go mod tidy

做完这些，你的本地模块导入应该就能正常工作了！

额外小提醒 #

• 模块根目录下会生成go.mod和go.sum文件，这俩是Go模块的核心配置文件，别随便删掉或者手动乱改。
• 现在用Go模块的话，完全不用把项目放到GOPATH/src下面了——模块功能就是为了摆脱GOPATH的限制，放在你电脑的任意位置都可以。

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