GoLand中replace不生效，八成是go.mod位置或格式错误：replace必须写在require块之后、文件末尾，左侧路径与import完全一致，右侧须为含匹配module声明的./开头相对路径。
GoLand里replace不生效，八成是go.mod位置或格式错了
GoLand本身不提供“自动替换依赖路径”的开关，所有替换逻辑都由Go工具链驱动，IDE只是读取和高亮已写入go.mod的replace语句。你看到的“没反应”，基本是replace没被Go识别——不是IDE问题，而是go.mod写法违规。
必须确认三点：
-
replace语句在go.mod文件末尾、require块之后，且独立成行（不能缩进、不能嵌在require ( )里） - 左侧模块路径（如
github.com/sirupsen/logrus）必须和import语句里**完全一致**，包括大小写、斜杠、是否带v2等后缀 - 右侧本地路径必须以
./开头，且该目录下存在go.mod，其中module声明与左侧路径**逐字符匹配**
运行go mod tidy后立刻检查go.mod：如果replace行消失了，说明位置或语法错误，Go直接忽略并清理了它。
本地路径替换失败，优先检查module名大小写和go.mod内容
最常被忽略的硬性门槛：本地模块的go.mod第一行module声明，必须和replace左侧一模一样。Go对路径大小写敏感，github.com/Sirupsen/logrus ≠ github.com/sirupsen/logrus。
验证步骤：
- 进入本地路径（如
./local/logrus），执行cat go.mod | head -n1，确认输出是module github.com/sirupsen/logrus - 如果本地库是fork来的，原始
go.mod可能写的是大写Sirupsen，必须手动改成小写，否则replace永不触发 - 空
go.mod（只有module xxx没有require或代码）在某些Go版本中会被跳过，建议至少加一行require std或确保有导出符号
执行go list -m all | grep logrus，若输出仍是远程版本（如github.com/sirupsen/logrus v1.9.3），说明匹配失败，不是网络或代理问题。
GoLand终端里go mod tidy没反应？先看GOPROXY和GOSUMDB
GoLand底部Terminal默认继承系统环境，但经常不生效。它不会自动读取~/.bashrc或~/.zshrc里的export配置，尤其在国内网络环境下，这会导致go mod tidy卡住或校验失败。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
必须手动验证并设置：
- 在GoLand Terminal中运行：
go env GOPROXY，如果不是https://goproxy.cn,direct，就立即执行：go env -w GOPROXY=https://goproxy.cn,direct - 同样检查
go env GOSUMDB，推荐设为：go env -w GOSUMDB=off（调试期可关校验，避免因本地模块无签名报错） - 改完后重启GoLand Terminal，再跑
go mod tidy——此时才会真正去读本地路径、生成伪版本、更新go.sum
注意：GOSUMDB=off仅限开发阶段，CI/CD中必须恢复。
别信“自动”——replace必须手写或用go mod edit生成
GoLand没有“右键→Replace with local”这种功能。所谓“自动”，其实是靠命令行工具生成合规配置。手动编辑go.mod极易漏掉换行、多加空格、写错箭头符号（=>不能写成->或=>）。
安全做法是用go mod edit：
- 替换成本地路径：
go mod edit -replace=github.com/sirupsen/logrus=./local/logrus - 替换为fork远程版本：
go mod edit -replace=github.com/sirupsen/logrus=github.com/myorg/logrus v1.9.3-fix - 预览修改结果（不写入）：
go mod edit -print - 撤销某条replace：
go mod edit -dropreplace=github.com/sirupsen/logrus
执行完go mod edit命令后，必须跟一次go mod tidy，否则缓存不更新，IDE依然加载旧依赖。
复杂点在于：路径计算基准永远是go.mod所在目录，不是你当前shell位置；跨父级的../utils能用，但一旦项目结构挪动，它就失效——这点在团队协作时最容易被忽略。
