node-gyp解析VS版本失败：显示版本为undefined的排查求助

已安装VS2022（v17.12.3）及构建工具v14.42.34433，使用最新版node-gyp v11安装编译原生依赖时，出现如下异常提示：

find VS unknown version "undefined" found at "C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.42.34433"

明明路径中存在版本号14.42.34433，为何会出现该问题？相关错误日志如下：

npm error gyp sill find Python execFile result: err = null
npm error gyp sill find Python execFile result: stdout = "3.12.6\r\n"
npm error gyp sill find Python execFile result: stderr = ""
npm error gyp verb find Python - version is "3.12.6"
npm error gyp info find Python using Python version 3.12.6 found at "C:\Python312\python.exe"
npm error gyp verb get node dir no --target version specified, falling back to host node version: 22.12.0
npm error gyp verb install input version string "22.12.0"
npm error gyp verb install installing version: 22.12.0
npm error gyp verb install --ensure was passed, so won't reinstall if already installed
npm error gyp verb install version is already installed, need to check "installVersion"
npm error gyp verb got "installVersion" 11
npm error gyp verb needs "installVersion" 11
npm error gyp verb install version is good
npm error gyp verb on Windows; need to check node.lib
npm error gyp verb get node dir target node version installed: 22.12.0
npm error gyp verb build dir attempting to create "build" dir: C:\Users\daniel\AppData\Local\npm-cache\_cacache\tmp\git-clonemdv8FQ\build
npm error gyp verb build dir "build" dir needed to be created? Yes
npm error gyp verb find VS msvs_version was set from command line or npm config
npm error gyp verb find VS - looking for Visual Studio version 2019
npm error gyp verb find VS running in VS Command Prompt, installation path is:
npm error gyp verb find VS "C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.42.34433"
npm error gyp verb find VS - will only use this version
npm error gyp sill find VS processing installation: "C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.42.34433"
npm error gyp sill find VS - failed to parse version: undefined
npm error gyp sill find VS - found VC.MSBuild.Base
npm error gyp sill find VS - found VC.Tools.x86.x64
npm error gyp sill find VS - invalid versionYear: undefined
npm error gyp sill find VS vsInfo: [
npm error gyp sill find VS {
npm error gyp sill find VS path: 'C:\\Program Files\\Microsoft Visual Studio\\2022\\Community\\VC\\Tools\\MSVC\\14.42.34433',
npm error gyp sill find VS msBuild: null,
npm error gyp sill find VS toolset: null,
npm error gyp sill find VS sdk: null
npm error gyp sill find VS }
npm error gyp sill find VS ]
npm error gyp verb find VS unknown version "undefined" found at "C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.42.34433"
npm error gyp verb find VS could not find a version of Visual Studio 2017 or newer to use

可能的原因 #

• msvs_version配置指定了错误版本：日志显示node-gyp正在查找VS2019版本，但实际安装的是VS2022，配置与环境不匹配导致版本识别失败。
• node-gyp v11对新版VS2022适配不足：VS2022 v17.12.3属于较新版本，node-gyp v11的版本解析逻辑未覆盖该版本格式，无法从路径中正确提取版本信息，出现failed to parse version: undefined。
• VS安装组件不完整：日志中msBuild: null、toolset: null、sdk: null说明node-gyp无法获取VS核心组件信息，可能是安装时未勾选MSBuild、Windows SDK或C++构建工具的完整组件。

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