Go项目重命名需同步更新go.mod的module声明、所有import路径、CI/CD脚本等，仅改目录名不够；module名决定导入根路径，package声明无需修改。
Go 项目名不是单个开关能改的，它分散在文件系统路径、模块路径（go.mod）、包导入路径、代码中硬编码的字符串（如日志、配置、CLI help 文本）等多个地方。改错一处，go build 或 go run 就会报 “cannot find module” 或 “import path not resolved”。
改文件夹名只是第一步，不是全部
直接重命名项目目录（比如 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。改成：
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
module github.com/yourname/newproject
之后所有 import 都得跟着变——否则 Go 工具链找不到包。别指望 IDE 全自动修好跨模块引用，尤其是 vendor 或 replace 指向本地路径时。
包名（package xxx）和项目名无关
Go 的 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 文件（多模块工作区）——它里面写的目录路径是绝对或相对的，不随文件夹重命名自动更新，必须手动改。
