前端开发离不开 npm，Python 开发离不开 pip。但很多开发者在国内网络环境下都遇到过同样的困扰：npm install 卡在“fetch”阶段，pip install 卡在“Collecting”阶段，最后提示 ETIMEDOUT 或 ReadTimeoutError。明明浏览器能打开 npmjs.com 和 pypi.org，快连也显示已连接，为什么命令行就是装不上包？
原因在于，npm 和 pip 是独立的命令行工具，它们有自己的网络请求逻辑，默认不读取浏览器的代理设置，也不一定读取系统环境变量中的代理配置。要让他们走快连，需要在各自的配置文件中显式指定代理，或者使用镜像源。快连官网（kenlandd.com.cn）技术团队将在本文中，分别讲解 npm、yarn、pnpm、pip 的代理配置方法，并对比镜像源与代理两种方案的适用场景，帮助你把依赖安装流程彻底跑通。
一、为什么命令行装包会超时
npm 和 pip 在安装包时，会直接连接官方仓库（registry.npmjs.org、pypi.org）。这些仓库的服务器在境外，国内访问时可能因为网络波动、DNS解析、路由绕远等原因超时。浏览器的代理设置只对浏览器生效，命令行的网络请求不会自动继承。
此外，npm 和 pip 的配置层级较多：全局配置、用户配置、项目配置、环境变量、命令行参数，优先级各不相同。如果只在一处设置了代理，而实际生效的是另一处配置，就会出现“明明配了代理却不生效”的情况。
npm config get registry 和 pip config list，确认当前使用的仓库地址和已有配置，避免重复或冲突。
二、准备：确认快连代理端口
打开快连电脑版，进入“设置”或“高级设置”，查看“本地代理端口”或“HTTP 代理端口”，常见有 7890、1080、8080 等。记下端口号，本文示例统一使用 7890，实际请替换为你的端口。
同时确认快连处于连接状态，并且浏览器能正常访问 npmjs.com 和 pypi.org。如果浏览器都打不开，先解决快连连接问题。可以参考《快连电脑版连接不上怎么办？》进行排查。如果你还没有安装最新版快连，可以前往快连下载页面获取。
三、npm代理配置
1. 设置HTTP和HTTPS代理
在终端执行以下命令：
npm config set proxy http://127.0.0.1:7890 npm config set https-proxy http://127.0.0.1:7890
配置后，npm 的所有网络请求都会走快连代理。可以通过 npm config get proxy 和 npm config get https-proxy 查看当前配置。
2. 取消代理配置
如果不再需要代理，或者代理配置错误导致安装失败，可以取消：
npm config delete proxy npm config delete https-proxy
3. 使用.npmrc文件配置
npm 的配置实际保存在用户目录下的 .npmrc 文件中（Windows 通常是 C:\Users\用户名\.npmrc）。也可以直接编辑该文件，添加：
proxy=http://127.0.0.1:7890 https-proxy=http://127.0.0.1:7890
项目级配置可以放在项目根目录的 .npmrc 中，只对当前项目生效。团队协作时，建议将代理配置放在用户级，避免把个人代理地址提交到仓库。
四、yarn与pnpm代理配置
1. yarn
yarn 的代理配置命令：
yarn config set proxy http://127.0.0.1:7890 yarn config set https-proxy http://127.0.0.1:7890
取消配置：yarn config delete proxy 和 yarn config delete https-proxy。yarn 的配置保存在 ~/.yarnrc 中。
2. pnpm
pnpm 沿用 npm 的配置体系，可以直接使用 npm 的代理配置。如果单独设置，可以执行：
pnpm config set proxy http://127.0.0.1:7890 pnpm config set https-proxy http://127.0.0.1:7890
pnpm 的配置保存在 ~/.npmrc 或项目级 .npmrc 中，与 npm 共享。
五、pip代理配置
1. 命令行临时指定代理
最简单的方式是在安装时通过 --proxy 参数指定：
pip install requests --proxy http://127.0.0.1:7890
这种方式只对当前命令生效，适合临时测试。
2. 使用pip config持久化配置
执行以下命令将代理写入 pip 配置文件：
pip config set global.proxy http://127.0.0.1:7890
配置后，所有 pip 命令都会使用该代理。可以通过 pip config list 查看当前配置。取消配置：pip config unset global.proxy。
3. 手动编辑pip配置文件
pip 配置文件的位置因系统而异：
- Windows：
%APPDATA%\pip\pip.ini - macOS / Linux：
~/.config/pip/pip.conf或~/.pip/pip.conf
在文件中添加：
[global] proxy = http://127.0.0.1:7890
保存后即生效。如果同时使用了镜像源，可以在同一个文件中配置 index-url。
六、镜像源与代理：两种方案怎么选
除了代理，很多开发者会使用国内镜像源来加速 npm 和 pip。两种方案各有优劣，可以结合使用。
| 对比项 | 代理方案 | 镜像源方案 |
|---|---|---|
| 原理 | 请求经快连节点转发到官方仓库 | 请求发往国内镜像服务器 |
| 速度 | 取决于节点质量 | 通常较快，国内直连 |
| 包完整性 | 与官方一致 | 可能有同步延迟 |
| 适用场景 | 需要最新包、私有包、官方源 | 常用公开包、追求速度 |
| 配置复杂度 | 需要代理端口 | 只需改 registry |
如果只是安装常用公开包，镜像源通常更快、更简单。如果需要安装最新版本、使用私有仓库、或者镜像源同步不及时，代理方案更可靠。两者也可以同时配置：镜像源负责常规安装，代理作为备用。关于分流思路，可以参考《快连电脑版分域名分流规则编写入门》。
常用镜像源配置示例
npm 切换镜像源：
npm config set registry https://registry.npmmirror.com
pip 切换镜像源：
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
切换回官方源时，将地址改回 https://registry.npmjs.org 和 https://pypi.org/simple 即可。
七、验证代理是否生效
配置完成后，建议通过以下方法验证：
- 查看配置：执行
npm config get proxy、npm config get https-proxy、pip config list，确认代理地址和端口正确。 - 安装测试：执行
npm install lodash或pip install requests，观察是否能正常下载。如果之前超时，现在能快速完成，说明代理生效。 - 详细日志：npm 可以使用
npm install --loglevel verbose查看网络请求详情；pip 可以使用pip install -v查看详细日志。 - 出口IP：执行
curl -x http://127.0.0.1:7890 ipinfo.io，查看出口 IP 是否为快连节点 IP。
如果验证失败，先确认端口是否正确、快连是否连接、配置是否写入了正确的层级。npm 和 pip 的配置优先级不同，命令行参数高于环境变量，环境变量高于用户配置，用户配置高于全局配置。排查时可以从命令行参数开始逐层排除。
八、常见问题与排查
1. 配置了代理但npm install仍然超时
首先确认 npm config get proxy 返回的地址和端口正确。其次检查是否有环境变量 HTTP_PROXY、HTTPS_PROXY 覆盖了 npm 配置。最后确认快连节点是否正常，可以尝试更换节点。如果问题依旧，参考《快连电脑版连接不上怎么办？》排查网络。
2. pip安装提示SSL证书错误
部分代理或镜像源可能导致证书验证失败。可以临时使用 --trusted-host 参数，或检查系统时间是否准确。如果使用公司内网代理，可能需要安装企业根证书。不建议长期关闭证书验证，存在安全风险。
3. 代理和镜像源同时配置导致冲突
如果同时配置了代理和国内镜像源，请求会先走代理再访问镜像源，可能反而变慢。建议二选一：使用镜像源时取消代理，使用代理时使用官方源。可以通过 npm config get registry 和 npm config get proxy 确认当前组合。
4. 公司内网npm私有仓库无法访问
全局代理会导致访问公司内网仓库时也走代理，从而失败。建议只针对官方源配置代理，或者使用 noproxy 配置排除内网地址。npm 支持 npm config set noproxy 内网域名，pip 可以通过环境变量 NO_PROXY 排除。
5. WSL2中npm和pip不走代理
WSL2 有独立的网络环境，Windows 上的 npm 和 pip 配置不会自动继承。需要在 WSL2 中单独配置代理，或者设置 WSL2 的 http_proxy 环境变量。具体方法可以参考《快连电脑版WSL2子系统代理设置教程》。
6. 安装速度慢但不再超时
速度受节点质量、仓库服务器、本地带宽影响。可以尝试更换快连节点，选择延迟低、负载低的节点。对于大包，可以先用镜像源安装，需要最新版本时再切换代理。关于节点优化的更多方法，可以参考《快连电脑版节点延迟高怎么办？》。
7. 如何为不同项目使用不同配置
npm 支持项目级 .npmrc，pip 支持项目级 pip.conf 或虚拟环境内的配置。可以在项目根目录放置配置文件，只对当前项目生效。这样不同项目可以使用不同的源和代理，互不干扰。
九、最佳实践与注意事项
- 先确认配置层级：npm 和 pip 的配置有优先级，排查时先看实际生效的是哪一层。
- 代理与镜像二选一：不要同时配置，避免请求绕路。
- 项目级配置不入库：个人代理地址不要提交到代码仓库，使用用户级配置或环境变量。
- 记录配置命令：把 npm、pip 的配置命令记录下来，换机时快速恢复。
- 保持客户端更新：新版本可能优化代理端口和局域网访问，建议从快连下载页面获取最新版本。
- 分层排查：先确认浏览器能访问仓库，再确认命令行代理配置，最后确认认证和包名，避免盲目重装。
十、总结
npm 和 pip 的代理配置并不复杂，关键在于理解它们各自的配置层级和优先级。npm 通过 npm config 设置 proxy 和 https-proxy，pip 通过 pip config 设置 global.proxy，yarn 和 pnpm 也有对应命令。镜像源和代理是两种互补的方案，根据场景选择即可。配置完成后，通过查看配置、安装测试和日志验证，就能确认是否生效。
如果你在配置过程中遇到问题，或者想了解更多快连使用技巧，欢迎访问快连技术博客，或联系快连官方客服获取支持。快连技术团队会持续输出实用教程，帮助大家在各种开发环境中稳定、高效地使用快连。