---
title: "Mac 上的 npm error code ECONNREFUSED · Kilobat 指南"
url: "https://kilobat.app/zh-hant/guides/npm-econnrefused"
description: "Mac 上的 npm install 以 npm error code ECONNREFUSED 停止。有主機拒絕了連線。請檢查registry、代理伺服器和本機服務。"
---

# 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-hant/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`。
- 通常發生在代理伺服器或registry設定之後。

## 可能原因

- **代理伺服器設定指向不存在的東西。**設定了 `127.0.0.1` 或其他主機上的代理伺服器，但那裡沒有執行代理伺服器。
- **本機registry已關閉。**本機鏡像或快取已停止。
- **服務未啟用。**Node.js 文件指出，這通常是因為遠端主機上的服務未啟用。
- **呼叫本機伺服器的腳本。**測試或建置步驟可能呼叫了尚未啟動的伺服器。

## 如何檢查

1. 讀取錯誤中的位址和連接埠。
2. 顯示 npm 的代理伺服器和registry。

   ```
   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. 啟動位址所指的本機registry或伺服器。
3. 取消錯誤的代理伺服器變數。

   ```
   unset https_proxy http_proxy
   ```
4. 重試安裝。

## 常見問題

**ECONNREFUSED 和 ECONNRESET 一樣嗎？**

不一樣。ECONNREFUSED 是一開始就被拒絕。ECONNRESET 是關閉已開啟的連線。請參閱 [Mac 上的「npm error code ECONNRESET」](https://kilobat.app/zh-hant/guides/npm-econnreset)。

**為什麼它指出 127.0.0.1？**

npm 嘗試了本機位址，通常來自代理伺服器或registry設定。

## 資料來源

- [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-hant/guides/npm-econnreset): ECONNRESET 表示連線遭強制重設。
- [Mac 上的「npm error code ENOTFOUND」](https://kilobat.app/zh-hant/guides/npm-enotfound): ENOTFOUND 表示 DNS 查詢失敗。
- [Mac 版 Chrome 的 ERR_CONNECTION_REFUSED](https://kilobat.app/zh-hant/guides/err-connection-refused): ERR_CONNECTION_REFUSED 是 Chrome 的網路錯誤。
- [代理伺服器設定讓 Mac 上的 App 無法連線](https://kilobat.app/zh-hant/guides/proxy-settings-breaking-apps): 代理伺服器設定會讓流量經由另一台伺服器傳送。
