---
title: "Mac 上的“npm error code ECONNREFUSED”· Kilobat 指南"
url: "https://kilobat.app/zh-hans/guides/npm-econnrefused"
description: "Mac 上的 npm install 以 npm error code ECONNREFUSED 停止。某个主机拒绝了连接。检查软件源、代理和本地服务。"
---

# Mac 上的“npm error code ECONNREFUSED”

ECONNREFUSED 表示连接被拒绝。Node.js 文档的说法是：“No connection could be made because the target machine actively refused it.”

**让你的智能体来解决**拷贝一条提示词，适用于 Claude Code、Codex 或任何能使用终端的智能体。

我的 Mac 出现了这个问题：Mac 上的“npm error code ECONNREFUSED”。请阅读 https://kilobat.app/zh-hans/guides/npm-econnrefused.md，并和我一起逐步处理。如果缺少 Kilobat CLI，请安装：brew install seifip/kilobat/kilobat。请你自己运行指南中的终端和 kilobat 检查，并告诉我发现了什么。列出只有我才能完成的步骤。更改任何设置之前先问我。

适用于：npm 10 及更高版本打印“npm error”，更早的版本打印“npm ERR!”。所有当前 macOS 版本上的 Node.js。 · 核查日期：2026年10月29日

## 症状

- `npm install` 或某个脚本以 `npm error code ECONNREFUSED` 停止。
- 下一行会给出一个地址和端口，例如 `127.0.0.1:8080`。
- 它常常出现在代理或软件源设置之后。

## 可能的原因

- **指向空处的代理设置。**设置了 `127.0.0.1` 或其他主机上的代理，但那里并没有运行代理。
- **未启动的本地软件源。**本地镜像或缓存已停止。
- **未启用的服务。**Node.js 文档说明，这通常是远程主机上的服务未启用造成的。
- **调用本地服务器的脚本。**测试或构建步骤可能调用了尚未启动的服务器。

## 如何检查

1. 查看错误中的地址和端口。
2. 显示 npm 的代理和软件源。

   ```
   npm config get proxy
   npm config get https-proxy
   npm config get registry
   ```
3. 测试那个端口。

   ```
   nc -vz 127.0.0.1 8080
   ```
4. 显示代理环境变量。

   ```
   env | grep -i proxy
   ```

## 如何修复

1. 删除你用不到的代理设置。

   ```
   npm config delete proxy
   npm config delete https-proxy
   ```
2. 启动该地址所指的本地软件源或服务器。
3. 取消设置错误的代理变量。

   ```
   unset https_proxy http_proxy
   ```
4. 重试安装。

## 常见问题

**ECONNREFUSED 和 ECONNRESET 一样吗？**

不一样。ECONNREFUSED 是在开始时被拒绝。ECONNRESET 是关闭一个已打开的连接。参见[Mac 上的“npm error code ECONNRESET”](https://kilobat.app/zh-hans/guides/npm-econnreset)。

**为什么提到的是 127.0.0.1？**

npm 尝试了本地地址，通常来自代理或软件源设置。

## 参考资料

- [Node.js 文档：Common system errors](https://nodejs.org/api/errors.html#common-system-errors)
- [npm 文档：常见错误](https://docs.npmjs.com/common-errors)

核查日期：2026 年 10 月 29 日。

## 相关指南

- [Mac 上出现“npm error code ECONNRESET”](https://kilobat.app/zh-hans/guides/npm-econnreset): ECONNRESET 表示连接被强制重置。
- [Mac 上的“npm error code ENOTFOUND”](https://kilobat.app/zh-hans/guides/npm-enotfound): ENOTFOUND 表示 DNS 查询失败。
- [Mac 上 Chrome 中的 ERR_CONNECTION_REFUSED](https://kilobat.app/zh-hans/guides/err-connection-refused): ERR_CONNECTION_REFUSED 是 Chrome 的网络错误。
- [Mac 上代理设置导致 App 无法连接](https://kilobat.app/zh-hans/guides/proxy-settings-breaking-apps): 代理设置会让流量经由另一台服务器转发。
