配置完全相同的两台电脑执行npm install输出差异原因排查

我有两台配置完全相同的电脑：Windows 11系统、Node.js 14.17.1版本、npm 6.14.13版本、Typescript 4.5.5版本。使用同一个package.json文件执行npm install时，两台电脑的输出日志不同，生成的node_modules文件夹也存在差异，仅第二台电脑有绿色高亮的输出内容。我需要找出差异产生的原因，解决应用构建时的问题。

以下是我的package.json文件：

{
  "name": "gaffeweb",
  "description": "An Aurelia client application.",
  "version": "0.1.0",
  "repository": {
    "type": "???",
    "url": "???"
  },
  "license": "MIT",
  "dependencies": {
    "@flowjs/flow.js": "^2.11.2",
    "ag-grid-aurelia": "^20.2.0",
    "ag-grid-community": "^20.2.0",
    "ag-grid-enterprise": "^20.0.0",
    "aurelia-animator-css": "^1.0.4",
    "aurelia-binding": "2.1.7",
    "aurelia-bootstrapper": "2.3.3",
    "aurelia-breeze": "^2.2.0",
    "aurelia-dialog": "^1.1.0",
    "aurelia-i18n": ">=2.3.2",
    "aurelia-materialize-bridge": "1.2.5",
    "aurelia-templating": "^1.10.1",
    "aurelia-typed-observable-plugin": "^0.4.2",
    "aurelia-validation": "^1.6.0",
    "babel-eslint": "^10.0.1",
    "bluebird": "^3.5.3",
    "breeze-client": "^1.7.2",
    "i18next": "^6.1.2",
    "jquery": "^3.3.1",
    "jqueryui": "^1.11.1",
    "jstree": "^3.3.7",
    "materialize-css": "^1.0.0",
    "metro-dist": "^3.0.18",
    "moment": "^2.24.0",
    "node-sass": "^6.0.1",
    "nprogress": "^0.2.0",
    "requirejs": "^2.3.6",
    "select2": "^4.0.5",
    "svgxuse": "^1.2.6",
    "text": "github:requirejs/text#latest",
    "toastr": "^2.1.4",
    "trumbowyg": "^2.13.0",
    "tslib": "^1.9.3",
    "whatwg-fetch": "^2.0.4",
    "cors": "^2.8.5"
  },
  "peerDependencies": {},
  "devDependencies": {
    "@types/breeze": "^1.6.2",
    "@types/jquery": "^3.3.29",
    "@types/jqueryui": "^1.12.6",
    "@types/materialize-css": "^1.0.6",
    "@types/select2": "^4.0.47",
    "aurelia-cli": "^1.0.0-beta.11",
    "aurelia-testing": "^1.0.0",
    "aurelia-tools": "^2.0.0",
    "browser-sync": "^2.26.0",
    "connect-history-api-fallback": "^1.6.0",
    "debounce": "^1.2.0",
    "event-stream": "^3.3.3",
    "fs": "0.0.1-security",
    "gulp": "^4.0.0",
    "gulp-changed-in-place": "^2.3.0",
    "gulp-htmlmin": "^5.0.1",
    "gulp-notify": "^3.2.0",
    "gulp-plumber": "^1.2.0",
    "gulp-rename": "^1.4.0",
    "gulp-sass": "^4.0.1",
    "gulp-shell": ">=0.6.5",
    "gulp-sourcemaps": "^2.6.4",
    "gulp-tslint": "^8.1.3",
    "gulp-typescript": "^5.0.0-alpha.3",
    "gulp-watch": "^5.0.1",
    "html-minifier": "^3.5.20",
    "merge2": "^1.2.3",
    "minimatch": "^3.0.4",
    "through2": "^2.0.3",
    "tslint": "^5.12.1",
    "typescript": "^3.2.4",
    "vinyl-fs": "^3.0.3"
  }
}

可能的差异原因 #

• npm缓存不一致：npm会缓存已下载的包，两台电脑的缓存内容可能不同，导致部分包从缓存读取、部分重新下载，最终node_modules结构和日志输出出现差异。
• 缺少或不一致的package-lock.json：如果没将package-lock.json纳入版本控制，两台电脑安装时会重新生成锁文件，npm会根据当前可用包版本解析依赖，可能生成不同的依赖树。
• 网络环境差异：网络波动或不同的镜像源，可能导致部分包下载路径或版本不同，npm自动调整安装策略，引发输出和依赖结构差异。
• 全局包干扰：即使本地Node.js版本一致，全局安装的工具或插件可能影响本地项目的依赖解析逻辑。
• 文件系统权限差异：Windows系统下不同的文件读写权限，可能导致部分包的安装脚本执行异常，生成的文件内容有区别。

解决步骤 #

1. 清理npm缓存：在两台电脑上执行npm cache clean --force，清除缓存后重新运行npm install。
2. 统一package-lock.json：确保项目中存在package-lock.json并同步到两台电脑，使用锁文件锁定依赖版本，保证依赖树完全一致。
3. 检查并统一镜像源：执行npm config get registry查看当前源，确保两台电脑使用相同的源（如官方源），必要时用npm config set registry https://registry.npmjs.org/统一配置。
4. 对比全局包：运行npm list -g --depth=0查看全局包，移除不必要的全局包，避免干扰本地项目。
5. 重新安装依赖：删除两台电脑上的node_modules文件夹和package-lock.json，执行npm install从头安装依赖。
6. 检查文件权限：确保两台电脑对项目目录有相同的读写权限，避免权限问题导致安装异常。

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