根本原因是 GOPROXY 与 GONOPROXY 协同失效:公有包需走代理(如 https://goproxy.cn,direct),私有包须通过 GONOPROXY 精确匹配域名绕过代理,且 gopls 需重启、go mod tidy 同步验证。

混合网络下 Go 模块下载失败,根本原因不是代理没开,而是 GOPROXY 和 GONOPROXY 的协同失效——公有包走代理、私有包绕过代理,两者必须同时生效且互不干扰。
为什么 go get 一直卡在 resolving... 或 timeout
常见现象是 go get 卡住几秒后报错:Get "https://proxy.golang.org/...": dial tcp: i/o timeout,或直接返回 no required module provides package。这不是网络连不上,而是 Go 工具链没按预期路由请求:它试图用默认 proxy.golang.org 去拉私有模块(404),又没把公有模块交给国内镜像(超时)。
- Go 1.13+ 默认启用
GOPROXY,但若未显式设置,仍会 fallback 到直连,而国内直连基本不可用 -
GONOPROXY不是可选配置,而是强制项——只要涉及公司内网域名、GitLab 地址、SSH 路径,就必须列入,否则replace或go mod download都会失败 - VSCode 中
gopls不读 shell 环境变量,只认工作区或用户级go.toolsEnvVars,改了系统环境变量却不配 VSCode,等于没改
GOPROXY 必须带 direct,且不能用阿里云镜像
GOPROXY 值必须包含 direct,否则私有模块无法 fallback;但阿里云镜像 https://mirrors.aliyun.com/goproxy/ 缺少 /@v/vX.Y.Z.info 等语义化路径支持,gopls 和 go list -m all 会静默失败。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
- 推荐值:
https://goproxy.cn,direct——七牛镜像兼容完整,校验可靠,响应快 - Windows 用户避免用
setx写注册表再重启终端,直接在 VSCode 设置里加:"go.toolsEnvVars": {"GOPROXY": "https://goproxy.cn,direct"} - 不要写成
https://goproxy.cn/(末尾斜杠会导致某些工具解析错误)
GONOPROXY 要匹配域名层级,通配符不匹配路径
GONOPROXY 控制哪些域名跳过代理,但它只做子域名匹配,不解析路径。比如设 GONOPROXY=*.corp.company,能匹配 git.corp.company 和 api.git.corp.company,但不能匹配 git.corp.company/internal ——后者仍需靠 replace 或显式列出完整域名。
- 多个域名用逗号分隔,无空格:
go env -w GONOPROXY="git.corp.company,example.com/internal" - 如果私有模块用 SSH 地址(如
git@example.com/internal.git),则匹配example.com即可,Go 会自动提取 host - 执行
go env确认输出中GONOPROXY已生效,而非显示(unset)
改完配置后 gopls 仍报 no package?重启 + tidy 是硬性步骤
VSCode 的 gopls 会缓存旧的环境变量和模块状态,单纯改配置不触发重载。它不会自动感知 go.mod 变更,也不会重新索引 vendor 或 proxy 返回的包结构。
- 必须手动执行:
Cmd/Ctrl + Shift + P→ 输入Go: Restart Language Server - 确保当前打开的文件夹是 module 根目录(含
go.mod),否则gopls退化为 GOPATH 模式,所有模块功能失效 - 运行
go mod tidy强制同步依赖,它会根据当前GOPROXY和GONOPROXY实际拉取并写入go.sum,这是验证配置是否真正生效的唯一可靠方式
真正卡住的往往不是配置本身,而是 gopls 没读到新环境变量,或者 go.mod 里残留了已失效的 replace 语句——后者会让 Go 工具链忽略 GONOPROXY 规则,直接走本地路径或报错。


















