答案：go get 报 401/403 主因是 goprivate 漏配，导致 go 强制经代理拉取私有模块而无权限；需执行 go env -w goprivate="github.com/my-org/*,git.internal.company.com" 显式豁免，并同步配置 gonosumdb 一致，禁用校验。
go get 报 401 或 403：不是双因子问题，是 GOPRIVATE 漏配
Go 工具链本身不支持 GitHub 的双因子验证（2FA），但它也根本不需要——go get 和 go mod download 从不走 GitHub 的 OAuth 流程，而是直接走 Git 协议或 HTTPS 克隆。所谓“双因子报错”，99% 是因为私有仓库域名没加进 GOPRIVATE，导致 Go 强制走代理去拉取，而代理无权限访问你的私有库，最终返回 401/403。
- 典型错误信息：
go: github.com/my-org/internal@v0.1.0: 403 Forbidden或go: github.com/my-org/internal@v0.1.0: 401 Unauthorized - 真实原因：Go 默认把所有模块都当公共模块处理，尝试通过
GOPROXY（如https://goproxy.cn）中转拉取，但该镜像站无法认证你对私有库的访问权限 - 解决动作：必须显式告诉 Go 哪些域名是私有的，跳过代理直连
执行：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
go env -w GOPRIVATE="github.com/my-org/*,git.internal.company.com"
注意：GOPRIVATE 值里不能有空格，通配符 * 只支持末尾匹配（如 github.com/my-org/* 合法，*/internal 不合法），多个域名用英文逗号分隔。
go list -m all 显示模块但 go mod download 失败：GOSUMDB 拦截了私有模块校验
即使 GOPRIVATE 配对成功，go mod download 仍可能卡在 verifying github.com/my-org/internal@v0.1.0 这一步，并报 checksum mismatch 或连接 sum.golang.org 超时。这是因为 Go 默认仍会尝试用 GOSUMDB 校验私有模块——但私有模块没有、也不该上传校验和到公共数据库。
- 现象：命令卡住几秒后报错
dial tcp 142.251.42.241:443: i/o timeout（这是sum.golang.org的 IP） - 关键点：
GOPRIVATE只控制下载路径，不自动关闭校验；必须同步配置GONOSUMDB（或GOSUMDB=off） - 推荐做法：让
GONOSUMDB与GOPRIVATE完全一致
执行：
go env -w GONOSUMDB="github.com/my-org/*,git.internal.company.com"
验证是否生效：go env GOPRIVATE GONOSUMDB 应输出相同值。若只设 GOPRIVATE 而漏掉 GONOSUMDB，就等于关了门却没关窗——校验请求仍会外泄。
临时调试：用 GOPROXY=direct + -v 快速定位到底是哪一环断了
当不确定是代理问题、权限问题还是 DNS 问题时，绕过所有中间层最有效。用 GOPROXY=direct 强制直连源站，配合 -v 查看完整路径和状态码，能一眼看出失败环节。
-
GOPROXY=direct go mod download -v：如果成功，说明原GOPROXY配置或镜像站本身有问题 - 如果仍失败，且错误含
dial tcp或no such host，说明是 DNS 或网络策略问题（比如公司防火墙屏蔽了github.com的 443 端口） - 如果报
fatal: could not read Username或repository not found，说明 Git 凭据未配置或 SSH key 未加载（此时需检查~/.netrc或ssh-agent）
注意：GOPROXY=direct 仅本次命令生效，不影响全局配置；搭配 go env -w GOPROXY=direct 是持久化操作，开发中慎用，避免误伤公共模块加速。
私有模块路径拼写错误被当成“双因子失败”：go mod tidy 不报错但运行时报 no required module
一个隐蔽但高频的问题：你在 import 语句里写了 github.com/my-org/internal，但实际仓库地址是 github.com/my-org/internal-lib。Go 不会立刻报错，go mod tidy 也能跑过，但运行时提示 no required module provides package github.com/my-org/internal。新手常误以为是认证失败，反复折腾 token 和 SSH。
- 排查方法：
go list -m all | grep my-org，看列出的模块路径是否与import完全一致（包括大小写、连字符） - 更准的方式：
go mod graph | grep my-org，观察依赖图中该模块的真实路径 - 修复动作：要么修正
import路径，要么在go.mod中用replace指向正确地址
这类拼写问题不会触发 HTTP 401/403，但日志里出现 unrecognized import path 或 module lookup failed 时，优先查路径而非认证。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
