go mod edit 不能直接手动编辑 go.mod 文件，因其易导致缩进错误、版本格式错误（如漏 v 前缀）、括号缺失或 replace 语法错位，引发 go build 或 go list 报错；而 go mod edit 由 go 工具链原生支持，自动校验语法、补全结构并触发依赖验证。
go mod edit 为什么不能直接改 go.mod 文件
手动编辑 go.mod 看似简单，但容易出错：缩进不一致、版本号格式错误（比如漏掉 v1.2.3 的 v 前缀）、require 行缺少括号包裹、replace 语法写错位置，都会导致 go build 或 go list 报错，典型如：go: malformed module path "github.com/foo/bar": leading dot 或 go: go.mod file not found。而 go mod edit 是 Go 工具链原生支持的编辑器，它会自动校验语法、补全括号、统一缩进，并触发后续依赖解析验证。
添加/移除依赖时该用 go get 还是 go mod edit -require
日常开发中，优先用 go get：它不仅写入 go.mod，还会下载模块、更新 go.sum、检查兼容性，并在代码里有实际 import 时才真正生效。而 go mod edit -require=xxx 只是强行写入 require 行，不下载、不校验、不生成 checksum，容易留下“幽灵依赖”——go build 会失败，报错类似：cannot find module providing package xxx。
- 需要立即生效且已有 import 语句 → 用
go get github.com/sirupsen/logrus@v1.9.3 - 只是预设未来要引入（比如文档或 CI 配置）→ 才考虑
go mod edit -require=github.com/sirupsen/logrus@v1.9.3，但务必紧跟着跑一次go mod tidy - 想删掉某个没被 import 的包 → 不要用
go mod edit -droprequire，直接go mod tidy更安全；它会自动清理未引用的 require 行
本地路径替换依赖的正确写法
go mod edit -replace 是调试本地 fork 或并行开发时的关键操作，但路径必须是相对当前项目根目录的**有效路径**，且目标目录下必须有合法的 go.mod 文件。
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 错误写法：
go mod edit -replace github.com/gorilla/mux=~/src/my-mux（波浪线 ~ 不展开，Go 不识别） - 错误写法：
go mod edit -replace github.com/gorilla/mux=./mux（./mux不存在或无go.mod） - 正确写法：
go mod edit -replace github.com/gorilla/mux=../my-mux（上层目录存在且含go.mod） - 执行后必须运行
go mod tidy，否则 replace 不生效，go build仍拉远程版本
go mod edit -fmt 和 -droprequire 的真实用途
go mod edit -fmt 不是“美化代码”，而是修复 go.mod 的结构合法性：把散落的 require 行归并进括号块、删除空行、修正 module 路径大小写、补全缺失的 go 版本声明。它常用于从旧项目迁移或多人协作后格式混乱的场景。
go mod edit -droprequire 几乎只在两种情况有用：
- 你确定某个依赖已被其他模块间接引入，且你想强制它不作为直接依赖出现在 go.mod 中（例如避免版本冲突）
- CI 流水线中需临时剥离某项 require（如测试不同版本组合），但必须配合
go mod tidy后续清理
注意：-droprequire 不会删掉间接依赖（indirect 标记的行），也不会影响 vendor 或缓存，它只动 go.mod 的顶层 require 块。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
