npm ci修改package-lock.json格式（内容未变），生产环境如何规避？

问题现象 #

• 生产服务器执行git pull + npm ci后，git status提示package-lock.json已修改
• 执行git diff --ignore-all-space package-lock.json无输出，说明文件仅存在空格/制表符的缩进差异
• 本地npm版本为10.4.0（使用空格缩进），生产环境npm版本为10.2.1（使用制表符缩进）

根本原因 #

不同npm版本对package-lock.json的缩进格式处理逻辑不一致，部分旧版本（如10.2.1）默认用制表符生成缩进，而新版本（如10.4.0）默认使用空格，导致npm ci后文件格式与仓库中内容产生差异。

解决方案 #

1. 统一npm版本（推荐） #

将生产环境的npm升级到与本地一致的版本，直接消除版本差异带来的格式问题：

npm install -g npm@10.4.0

升级后重新执行npm ci，package-lock.json的缩进格式会和仓库保持一致，git status不会再提示文件修改。

2. 配置npm强制统一缩进格式 #

如果暂时无法升级npm版本，可以通过npm配置强制指定缩进规则，确保不同环境生成的package-lock.json格式一致：

• 临时生效（仅当前终端会话）：

npm config set package-lock-indent 2

• 持久化生效（写入项目根目录的.npmrc文件）：

package-lock-indent=2

配置后，无论使用哪个npm版本，生成或更新package-lock.json时都会使用2个空格作为缩进，避免格式差异。

验证步骤 #

配置完成后，按以下步骤验证效果：

1. 执行git checkout package-lock.json恢复仓库中的原始文件
2. 执行npm ci重新安装依赖
3. 执行git status检查是否还会提示package-lock.json修改

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