golang 怎么更改项目名

很多开发者以为改 Go 项目名就是改个文件夹名，结果一编译报错，才发现事情没那么简单。项目名这东西，在 Go 世界里是散落在多个地方的：文件系统路径、go.mod 里的模块路径、所有 import 语句、甚至日志和 CLI help 里写死的字符串。改错一处，go build 或者 go run 就会直接甩你一句“cannot find module”。

改文件夹名只是第一步，不是全部

直接 mv myapp newapp 只解决了最表层的问题——目录名字换了，但背后所有依赖这个路径的逻辑都得跟着动。比如：

• go.mod 里的 module 声明必须改成新路径，例如 module github.com/user/newapp
• 所有 import 语句里的旧路径（如 "github.com/user/myapp/config"）都得批量替换
• 如果项目用 go install 安装命令，安装目标（比如 myapp）通常也得改，否则二进制名还是老的
• CI/CD 脚本、Dockerfile、Makefile 里写死的路径或镜像名，一个都不能漏

go.mod 的 module 名决定 Go 的导入根路径

Go 不认文件夹名，只认 go.mod 里的 module 行。这个字符串就是整个项目的“导入前缀”。举个例子：

module github.com/yourname/oldproject

那么所有子包都必须以这个为前缀去导入：github.com/yourname/oldproject/internal/handler。一旦改成：

module github.com/yourname/newproject

所有 import 都得跟着变——不然 Go 工具链根本找不到包。别指望 IDE 能自动修好跨模块引用，尤其是当项目用了 vendor 或 replace 指向本地路径时，你得自己动手。

包名（package xxx）和项目名无关

package main 或 package config 是编译单元作用域，不参与导入解析。你可以把整个项目从 myapp 改成 newapp，但所有 package 声明完全不用动。混淆这点会导致你跑去批量替换 package myapp——纯属白忙一场。

真正需要批量替换的是导入路径字符串。用 grep -r "github.com/yourname/oldproject" . --include="*.go" 扫一遍，再用编辑器的「替换全部」处理，比猜哪些文件要改靠谱得多。

Windows 和 macOS 下重命名项目目录要小心路径缓存

某些编辑器（比如 Goland）或 shell 会缓存工作目录的 inode 或路径状态。你用 mv 改完名后，如果还在原目录下执行 go run .，可能因为 GOPATH 或 go.work 缓存导致构建失败。建议这么做：

• 关闭 IDE，删掉 .idea 目录（Goland）或 .vscode（VS Code），然后重新打开新文件夹
• 运行 go clean -modcache 清掉模块缓存
• 确认当前终端已经 cd 进了新目录，别靠相对路径残留操作

最容易忽略的是 go.work 文件（多模块工作区）——它里面的目录路径是绝对或相对的，不会随文件夹重命名自动更新，必须手动改。