网络环境配置指南
面向国内开发环境的网络检查清单，帮助你减少 GitHub、npm、Homebrew 和 AI 工具连接失败的问题。
做海外部署的网站或 App，稳定的网络环境是必须的。至少要保证浏览器和终端都能访问常见的开发服务。
这篇文章只讨论开发体验层面的检查和排错，具体的网络方案请遵守所在地法律法规，选择你能接受、能长期维护的方案。
为什么网络环境会卡住开发
开发过程中会频繁访问海外服务：
- 安装开发工具：Homebrew、Node.js、Git
- 下载依赖包：很多 npm 包和 GitHub Release 资源在海外
- 拉取代码：大量开源项目托管在 GitHub
- 查阅文档：官方文档、Stack Overflow、框架示例
- 使用 AI 工具：模型服务、插件市场、登录认证都依赖稳定连接
网络不稳定的常见表现：
| 类型 | 具体表现 |
|---|---|
| 安装失败 | brew install、pnpm install 卡住或超时 |
| 依赖下载慢 | 同一个项目别人 1 分钟装完，你装半小时 |
| Git 失败 | git clone 很慢，或者报连接中断 |
| AI 工具不可用 | 登录失败、请求失败、模型响应很慢 |
先做两个检查
先检查浏览器能否打开：
https://github.comhttps://www.npmjs.com- 你正在使用的 AI 工具官网
再检查终端能否访问：
curl -I https://github.com
curl -I https://registry.npmjs.org返回 HTTP/2 200、HTTP/1.1 200、301、302 这类响应，说明连接是通的。
出现这些报错，说明网络或 DNS 需要处理：
curl: (6) Could not resolve host
curl: (7) Failed to connect
Operation timed out代理工具要注意什么
用代理工具的话，重点不是”浏览器能打开网页”，而是终端也要能走通。
优先检查：
- 是否开启系统代理
- 是否开启增强模式、TUN 模式或类似能力
- 终端是否继承了代理环境
- 节点是否稳定，延迟是否太高
- AI 工具是否被代理规则正确覆盖
很多新手的问题是：浏览器能访问 GitHub，但终端里的 git clone、pnpm install 仍然失败。这通常是终端没有走代理，需要设置 TUN 模式或者设置环境变量。
镜像
镜像站是为了解决无法访问海外网站的问题，比如 npm / docker / python 镜像站等。
举个例子，下面是 npm 的镜像站之一，在终端运行一个指令来配置：
pnpm config set registry https://registry.npmmirror.com镜像源能解决一部分下载问题，但也有边界：
- 有些包版本同步会滞后
- 有些 GitHub 资源仍然下载不到
- 不同工具要分别配置镜像
- 镜像源偶尔也会不可用
更稳的策略是：代理解决大部分访问问题，镜像作为补充。
Homebrew 安装慢怎么办
Homebrew 安装很慢的话，先别急着复制一堆镜像脚本。优先确认：
- 终端是否能访问
github.com - 终端是否能访问
raw.githubusercontent.com - 代理工具是否对终端生效
很多时候，解决终端代理后，Homebrew、Git、pnpm 的问题会一起消失。
什么时候继续往下走
下面这些命令都能正常返回结果时，就可以继续配置开发环境：
git --version
node --version
pnpm --version
curl -I https://github.com
curl -I https://registry.npmjs.org