macOS上Node.js依赖下载中断本质是网络、缓存、权限三者叠加所致，修复关键为：换国内镜像源（如npm config set registry https://registry.npmmirror.com）、强制清理缓存（npm cache clean --force）、删除node_modules与package-lock.json、加--legacy-peer-deps重装，并修复sudo导致的root权限归属问题。
macos 上 node.js 依赖包下载中断，本质是网络不稳定、缓存损坏或权限错乱三者叠加的结果。修复不靠重装，关键在“断点清理 + 源切换 + 权限归位”。
换国内镜像源，绕过网络卡点
npm 默认走国外 registry，国内用户常因 DNS 解析慢、TLS 握手超时或 CDN 回源失败导致中断。直接切到稳定镜像：
- 设为淘宝镜像（同步快、兼容好）：npm config set registry https://registry.npmmirror.com
- 验证是否生效：npm config get registry，输出应为
https://registry.npmmirror.com - 如需临时单次使用（不影响全局）：npm install --registry=https://registry.npmmirror.com
强制清空缓存，排除脏数据干扰
中断后残留的半成品包会污染后续安装，尤其常见于 tarball extract failed 或 integrity checksum failed 报错：
- 执行强制清理：npm cache clean --force
- 手动确认缓存目录是否真清空：ls $(npm config get cache)，正常应只留
_cacache和空文件夹 - 若仍有残留（如
_locks或破损 tar），直接删整个缓存目录：rm -rf $(npm config get cache)
删 node_modules + lock 文件，重建依赖树
中断安装常导致 node_modules 不完整、package-lock.json 记录与实际不一致，引发后续 peer dep missing 或 ERESOLVE 错误：
- 进项目根目录，一次性清理：rm -rf node_modules package-lock.json
- 重装时加容错参数（尤其 Vue2/React17 等老项目）：npm install --legacy-peer-deps
- 若仍报某包失败，可单独装它：npm install 包名 --no-save，再补全其他
检查并修复权限归属，避免 sudo 后遗症
曾用 sudo npm install -g 会把全局模块属主设为 root，之后普通用户运行 npm install 可能因写入 node_modules/.staging 失败而中断：
- 查当前全局路径：npm config get prefix，若为
/usr/local就高风险 - 看该路径下模块归属：ls -ld $(npm config get prefix)/lib/node_modules
- 若 owner 是
root，立即修复：sudo chown -R $(whoami) $(npm config get prefix)/lib/node_modules - 顺手修缓存目录：sudo chown -R $(whoami) $(npm config get cache)
