为何启动NextJs应用后package-lock.json会新增额外Node模块配置？

我有一个基于NextJs & ReactJs的应用，package.json中的核心依赖如下：

"next": "^13.3.1",
"next-auth": "^4.20.1",
"next-http-proxy-middleware": "^1.2.5",
"next-pwa": "^5.6.0",

已执行npm install安装所有依赖并更新package-lock.json，且两者已提交到项目仓库。运行npx next dev启动应用后，package-lock.json末尾新增了一批@next/swc-*相关的Node模块配置，示例如下：

"node_modules/@next/swc-win32-x64-msvc": {
  "version": "13.3.1",
  "resolved": "https://registry.npmjs.org/@next/swc-win32-x64-msvc/-/swc-win32-x64-msvc-13.3.1.tgz",
  "integrity": "sha512-Sl1F4Vp5Z1rNXWZYqJwMuWRRol4bqOB6+/d7KqkgQ4AcafKPN1PZmpkCoxv4UFHtFNIB7EotnuIhtXu3zScicQ==",
  "cpu": [
    "x64"
  ],
  "optional": true,
  "os": [
    "win32"
  ],
  "engines": {
    "node": ">= 10"
  }
}

其余如@next/swc-darwin-x64、@next/swc-linux-arm64-gnu等模块结构类似。

我的疑问：

1. 为什么会出现这种情况？
2. 是否需要将更新后的package-lock.json推送到仓库？

1. 新增模块的原因 #

• Next.js从版本12开始，默认使用SWC（Speedy Web Compiler）替代Babel作为编译器、代码压缩工具，以此提升构建和开发阶段的速度。
• 这些@next/swc-*模块是平台特定的SWC二进制包，分别对应不同操作系统（Windows、macOS、Linux）和CPU架构（x64、arm64等）。
• 执行npm install时，npm只会安装适配当前运行环境的SWC包；但启动next dev时，Next.js会触发跨平台SWC包的解析流程，或者npm的可选依赖处理机制补全了这些配置，最终这些标记为optional: true的跨平台包条目被添加到package-lock.json中——它们仅会在对应平台环境下才会实际安装。

2. 是否需要推送更新后的package-lock.json到仓库 #

建议推送，原因如下：

• package-lock.json的核心作用是锁定依赖的版本和安装结构，确保所有开发人员、CI/CD环境安装依赖时能得到完全一致的依赖树。
• 新增的可选依赖条目只是补全了跨平台配置，不会在非对应平台上实际安装，也不会增加本地依赖体积。
• 推送后，团队中使用不同操作系统的成员执行npm install时，npm可以直接从lock文件中获取对应平台SWC包的版本和校验信息，既避免版本不一致问题，也能加快依赖安装速度。
• 如果不推送，其他成员启动项目时可能会重新生成这些条目，导致lock文件频繁变更，反而容易引发代码冲突。

内容的提问来源于stack exchange，提问作者axel