模块路径应使用代码托管地址根路径，如github.com/yourname/myapp；internal/限制包访问范围，pkg/存放明确对外提供的公共子模块；构建用goos/goarch控制输出，依赖升级需显式指定版本并运行go mod tidy。
go mod init 初始化时模块路径怎么选
模块路径不是随便写的，它直接影响后续依赖引用、版本发布和 IDE 识别。最稳妥的做法是用代码托管地址的根路径，比如 GitHub 项目 github.com/yourname/myapp，即使本地还没 push 也建议按这个格式初始化。
常见错误是写成 myapp 或 ./myapp，这会导致：
• 其他项目无法正确 go get 引用你的模块
• GoLand 等工具识别为“无模块”，自动导入失效
• 后续发布 v1.0.0 时 go list -m all 显示路径不一致
- 私有仓库用公司域名，如
git.company.com/team/project，并配好GOINSECURE或git config认证 - 本地开发调试阶段可临时用
example.com/local，但上线前必须替换 - 避免路径含大写字母或下划线，Go 模块名约定使用小写短横线（kebab-case）
如何组织 internal/ 和 pkg/ 目录边界
internal/ 不是语法强制，而是 Go 的隐式访问控制机制：任何在 internal/ 下的包，只能被其父目录或祖先目录的其他包导入。它解决的是“哪些代码能被外部依赖调用”这个问题。
pkg/ 则是社区约定，用于存放**明确对外提供能力**的公共子模块，比如 pkg/auth、pkg/storage。它的存在意味着你愿意为这些接口做向后兼容保证。
立即学习“go语言免费学习笔记（深入）”；
CPWEB企业网站管理系统（以下称CPWEB）是一个基于PHP+Mysql架构的企业网站管理系统。CPWEB 采用模块化方式开发，功能强大灵活易于扩展，并且完全开放源代码，面向大中型站点提供重量级企业网站建设解决方案。CPWEB企业网站管理系统 2.2 Beta 测试版本，仅供测试，不建议使用在正式项目中，否则发生任何的后果自负。
-
internal/handler放 HTTP 路由和请求编排逻辑，不导出给外部 -
pkg/config提供Load()函数，供主程序和其他模块统一读配置 - 不要把
internal/xxx加到go.mod的replace中——这会绕过 internal 规则，埋下耦合隐患
go build -o 时如何避免硬编码输出路径
直接写 go build -o ./bin/app main.go 在 CI 或多平台构建时容易出错。更可靠的方式是用 go build 的默认行为 + 环境变量控制。
Go 默认把二进制输出到当前目录，所以推荐在项目根目录执行：
GOOS=linux GOARCH=amd64 go build -o ./dist/app-linux-amd64 ./cmd/app
-
./cmd/app是入口包路径，不是文件名；确保该目录下有main.go且含func main() - 输出目录
./dist/应该加进.gitignore，别提交二进制 - Windows 下注意路径分隔符，CI 中优先用
GOOS=windows构建，而不是依赖 WSL
升级依赖时为什么 go get -u 不够用
go get -u 只更新直接依赖的最新 minor/patch 版本，但不会升级间接依赖（transitive deps），更不会处理版本冲突。真实项目中，经常遇到 go build 失败提示 “found packages xxx and yyy in …”，本质是两个依赖拉了不同版本的同一模块。
真正可控的方式是：
- 先运行
go list -u -m all查看所有可升级模块 - 对关键依赖（如
golang.org/x/net）用go get golang.org/x/net@v0.25.0显式指定版本 - 执行
go mod tidy清理未使用依赖，并重新计算最小版本集 - 检查
go.sum是否新增大量哈希行——如果太多，说明引入了不必要间接依赖
模块化不是靠目录结构撑起来的，而是靠 go.mod 里每一行 require 是否清晰表达了“我需要什么能力、谁来提供、版本边界在哪”。很多人卡在 go run 正常但 go test 报错，往往是因为测试文件跨了 internal/ 边界，或者 replace 规则没覆盖测试用例路径。
