Windows环境下执行Vue CLI快速入门时Yarn持续报网络连接错误怎么办

适用场景 #

以下操作针对Windows系统，覆盖已经完成更换公共源、调整Yarn超时阈值、清除缓存、关闭代理等通用修复手段后，仍在执行Vue CLI相关操作时触发「There appears to be trouble with your network connection. Retrying...」报错的场景。

第一步：清理全局Yarn配置的残留冲突 #

• 以管理员权限打开Windows Terminal/PowerShell，执行 yarn config list 导出当前全量配置，重点核对是否存在失效的代理、仓库地址配置项
• 逐个删除全局残留的异常配置：
  • 执行 yarn config delete proxy 清除残留HTTP代理配置
  • 执行 yarn config delete https-proxy 清除残留HTTPS代理配置
  • 执行 yarn config delete registry 清除残留全局仓库地址
• 重新指定可连通的国内镜像源：yarn config set registry https://registry.npmmirror.com
• 手动核对两处配置文件的内容一致性：
  • 用户目录下的全局配置：C:\Users\当前系统用户名\.npmrc、C:\Users\当前系统用户名\.yarnrc
  • 项目目录下的本地配置：项目根路径下的.npmrc、.yarnrc
• 清理Yarn全量本地缓存，执行 yarn cache clean，不要手动删除缓存目录避免出现文件权限报错

第二步：排查Windows系统层面的网络拦截 #

• 关闭第三方代理工具的全局模式，切换为规则分流模式，避免Yarn发起的请求被误拦截
• 临时退出第三方安全软件（如各类电脑管家、杀毒工具）的实时网络防护功能，检查Windows防火墙出站规则中是否存在对node.exe、yarn.exe的拦截规则
• 手动在浏览器中测试镜像源连通性：访问https://registry.npmmirror.com/vue，如果无法正常返回结构化JSON内容，更换备用源：yarn config set registry http://mirrors.cloud.tencent.com/npm/
• 拉长Yarn网络超时阈值，适配慢网络场景：执行 yarn config set network-timeout 600000，将单请求超时时间设置为10分钟，减少不必要的重试触发

第三步：适配Vue CLI操作场景的专属优化 #

• 如果在执行vue create创建项目的流程中触发报错，可在项目初始化的依赖安装环节选择跳过，等项目脚手架生成完成后，手动进入项目目录再执行依赖安装
• 项目根目录手动新建.yarnrc文件，写入配置行 registry "https://registry.npmmirror.com"，保存后再执行 yarn install
• 卸载本地全局安装的旧版本Vue CLI：执行 npm uninstall -g @vue/cli，安装最新稳定版Vue CLI后再重试项目创建流程，避免旧版本CLI内置的Yarn调用逻辑存在兼容性问题

内容的提问来源于stack exchange，提问作者M. Behnasr