node_modules 要不要复制到新电脑？用 package-lock 和 npm ci 重建

结论：通常不复制 node_modules

node_modules 是根据 Node/npm 版本、操作系统、CPU 架构、锁文件和安装参数生成的产物。其中可能含原生扩展、符号链接和安装期脚本结果。把 macOS 生成的目录压缩到 Windows，或从 x64 复制到 ARM，即使文件完整也不能证明可用。

1. 迁移前保留这些

• package.json 和与当前包管理器匹配的锁文件。
• 项目级 .npmrc 中影响依赖树的非秘密参数；私有仓库 Token 不得提交。
• node --version、npm --version、包管理器和项目的 engines 要求。
• 一条干净安装后的构建、测试与启动命令。

2. 在新机器做干净安装

node --version
npm --version
npm ci
npm test
npm run build

npm 官方文档说明，npm ci 要求已有锁文件；如果锁文件与 package.json 不匹配会直接退出，而不是更新锁文件；如果已有 node_modules 会先移除，安装过程也不改写 package.json 和锁文件。这些性质非常适合做迁移验收。

3. npm ci 失败时怎么分类

• 锁文件不匹配：回到开发分支明确更新依赖并审查 diff，不要在部署机器上用 npm install 悄悄篡改锁文件。
• peer dependency 参数不同：若锁文件是使用 --legacy-peer-deps 等影响树结构的参数创建，npm 官方建议 npm ci 使用同样参数，并可把非敏感项目配置提交。
• 原生包编译失败：核对支持的 Node ABI、平台编译链与包版本，不要复制另一平台的二进制文件。

验收标准

1. 从没有 node_modules 的副本执行 npm ci 成功。
2. 安装后 Git 工作树没有 package.json/锁文件的意外变更。
3. 至少通过测试、构建和一次最小启动健康检查。

官方来源

• npm ci
• npm install 与锁文件