SPFx运行yo @microsoft/sharepoint报错及生成器安装失败求助

问题核心原因 #

• Node版本不兼容：你使用的SPFx 1.13.0生成器明确要求Node版本范围为>=12.13.0 <13.0.0 || >=14.15.0 <15.0.0，当前环境Node版本为16.13.0，完全不在支持范围内，这是最核心的报错诱因。
• 编译依赖不匹配：该版本SPFx生成器依赖的node-gyp 3.8.0仅支持Python 2，你当前环境仅安装了Python 3.10，老版本node-gyp调用Python执行的语法为Python 2专属的无括号print写法，在Python 3环境下直接触发语法错误，导致node-sass编译失败，最终生成器安装中断。

解决步骤 #

1. 切换适配的Node版本：使用nvm-windows（Windows系统）或nvm（类Unix系统）安装符合要求的Node 14 LTS版本，切换到该版本后再执行后续操作。如果希望继续使用Node 16，可以选择安装1.15及以上版本的SPFx生成器，该版本开始支持Node 16环境。
2. 清理残留文件：执行以下命令清理之前安装失败的残留内容：

npm uninstall @microsoft/generator-sharepoint -g
npm cache clean --force

3. 重新安装生成器：在Node版本匹配的环境下，重新执行全局安装命令：

npm install @microsoft/generator-sharepoint -g

如果仍出现node-gyp相关报错，可以安装Python 2.7并添加到系统环境变量的PATH中，再重新执行安装命令即可。
4. 验证安装结果：安装完成后执行yo --generators，如果输出列表中包含@microsoft/sharepoint即说明安装成功，此时再运行yo @microsoft/sharepoint即可正常创建SPFx项目。

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