npm install报错问题的定位处理思路

当使用一些github上他人开发的老项目时，由于依赖包的版本比较旧，在npm install时就可能会遇到一些奇怪的报错问题。
比如这里 clone完工程文件后，在运行 npm install时报错

gyp ERR! build error
gyp ERR! stack Error: `C:Program Files (x86)Microsoft Visual Studio2017BuildToolsMSBuild15.0BinMSBuild.exe` failed with exit code: 1
gyp ERR! stack     at ChildProcess.onExit (C:DevelopEnvironmentnodejsnode_modulesnpmnode_modulesnode-gyplibbuild.js:194:23)
gyp ERR! stack     at ChildProcess.emit (events.js:400:28)
gyp ERR! stack     at Process.ChildProcess._handle.onexit (internal/child_process.js:282:12)
gyp ERR! System Windows_NT 10.0.15063
gyp ERR! command "C:\Develop\Environment\nodejs\node.exe" "C:\Develop\Environment\nodejs\node_modules\npm\node_modules\node-gyp\bin\node-gyp.js" "build" "--fallback-to-build" "--loglevel=http" "--module=C:\Develop\Workspace\Javascript\simple-excel-parser-electron\node_modules\libxmljs\build\Release\xmljs.node" "--module_name=xmljs" "--module_path=C:\Develop\Workspace\Javascript\simple-excel-parser-electron\node_modules\libxmljs\build\Release" "--napi_version=8" "--node_abi_napi=napi"
gyp ERR! cwd C:DevelopWorkspaceJavascriptsimple-excel-parser-electronnode_moduleslibxmljs
gyp ERR! node -v v14.18.1
gyp ERR! node-gyp -v v5.1.0
gyp ERR! not ok
node-pre-gyp ERR! build error
node-pre-gyp ERR! stack Error: Failed to execute 'C:DevelopEnvironmentnodejsnode.exe C:DevelopEnvironmentnodejsnode_modulesnpmnode_modulesnode-gypbinnode-gyp.js build --fallback-to-build --loglevel=http --module=C:DevelopWorkspaceJavascriptsimple-excel-parser-electronnode_moduleslibxmljsbuildReleasexmljs.node --module_name=xmljs --module_path=C:DevelopWorkspaceJavascriptsimple-excel-parser-electronnode_moduleslibxmljsbuildRelease --napi_version=8 --node_abi_napi=napi' (1)
node-pre-gyp ERR! stack     at ChildProcess.<anonymous> (C:DevelopWorkspaceJavascriptsimple-excel-parser-electronnode_moduleslibxmljsnode_modulesnode-pre-gyplibutilcompile.js:83:29)
node-pre-gyp ERR! stack     at ChildProcess.emit (events.js:400:28)
node-pre-gyp ERR! stack     at maybeClose (internal/child_process.js:1058:16)
node-pre-gyp ERR! stack     at Process.ChildProcess._handle.onexit (internal/child_process.js:293:5)
node-pre-gyp ERR! System Windows_NT 10.0.15063
node-pre-gyp ERR! command "C:\Develop\Environment\nodejs\node.exe" "C:\Develop\Workspace\Javascript\simple-excel-parser-electron\node_modules\libxmljs\node_modules\node-pre-gyp\bin\node-pre-gyp" "install" "--fallback-to-build" "--loglevel" "http"
node-pre-gyp ERR! cwd C:DevelopWorkspaceJavascriptsimple-excel-parser-electronnode_moduleslibxmljs
node-pre-gyp ERR! node -v v14.18.1
node-pre-gyp ERR! node-pre-gyp -v v0.9.1
node-pre-gyp ERR! not ok
Failed to execute 'C:DevelopEnvironmentnodejsnode.exe C:DevelopEnvironmentnodejsnode_modulesnpmnode_modulesnode-gypbinnode-gyp.js build --fallback-to-build --loglevel=http --module=C:DevelopWorkspaceJavascriptsimple-excel-parser-electronnode_moduleslibxmljsbuildReleasexmljs.node --module_name=xmljs --module_path=C:DevelopWorkspaceJavascriptsimple-excel-parser-electronnode_moduleslibxmljsbuildRelease --napi_version=8 --node_abi_napi=napi' (1)
npm WARN simplepaser_electron@1.0.0 No repository field.

npm ERR! code ELIFECYCLE
npm ERR! errno 1
npm ERR! libxmljs@0.18.8 install: `node-pre-gyp install --fallback-to-build --loglevel http`
npm ERR! Exit status 1
npm ERR!
npm ERR! Failed at the libxmljs@0.18.8 install script.
npm ERR! This is probably not a problem with npm. There is likely additional logging output above.

npm ERR! A complete log of this run can be found in:
npm ERR!     C:UsersAdministratorAppDataRoamingnpm-cache_logs2023-03-08T04_06_31_972Z-debug.log

这里报错说的是在安装 libxmljs的时候出现了错误，但是查看自己的package.json 文件，里面并没有写到对libxmljs的依赖。

解决 方法

使用npm list 查看当前依赖树

npm list | grep libxmljs

输出结果中看到

npm ERR! missing: libxmljs@0.18.8, required by excel@1.0.0

而这里的excel库，正是package.json里写的依赖库。将这个依赖库去掉，删除node_modules目录，重新执行npm install，没有报错。这时再执行npm install –save excel，也能正常安装。
这可以作为一种类似问题的通用解决方案，当npm install报错没有头绪时，可以通过npm list来定位具体哪个包的依赖引起的，从而可以找到突破口。