NPM 安裝 Ionic 失敗：Registry 錯誤與網路代理配置解決方案

錯誤現象

npm ERR! registry error parsing json
npm ERR! SyntaxError: Unexpected token <
npm ERR! 404 Not Found
npm ERR! The requested URL /_gh/ was not found on this server

Node v0.10.35 / npm 1.4.28 (極舊版本)，Windows 環境。

根本原因

1. 版本過舊：Node 0.10.x 早已停止維護，TLS/SSL 協議不支援現代 registry (npmjs.org 已強制 HTTPS/HTTP2)。
2. 網路代理/GoAgent 干擾：錯誤中的 /_gh/、HTML 回應 (Unexpected token <) 典型為代理攔截返回登入頁面或 404 頁面，非 JSON。
3. Registry 源未切換：預設指向國外源，國內直連極不穩定。

完整解決步驟

1. 升級 Node.js：下載安裝 Node.js 18+ LTS (含 npm 9+)，自動解決 TLS/Registry 相容性。
2. 切換國內鏡像源：

npm config set registry https://registry.npmmirror.com
# 或使用 nrm 管理
npm install -g nrm
nrm use taobao

3. 關閉干擾代理：停用 GoAgent/Shadowsocks 等全域代理，或在 npm 配置正確 proxy：

npm config set proxy https://127.0.0.1:8080
npm config set https-proxy https://127.0.0.1:8080

4. 清理快取重試：

npm cache clean --force
npm install -g ionic

避坑指南

• 企業內網環境請聯繫 IT 確認 Nexus/Artifactory 私有倉庫地址。
• 專案鎖定 Node 版本請使用 nvm (Windows 用 nvm-windows) 管理多版本。
• package-lock.json / yarn.lock 必須提交版控，確保構建可復現。