Visual Studio 2022发布Blazor WASM至Azure SWA时npm未识别问题

原因排查与解决步骤 #

• 检查Node.js环境变量配置
  Visual Studio安装Node.js后，可能未自动将其路径添加到系统环境变量。手动配置步骤：

  1. 找到Node.js安装目录（通常为C:\Program Files\nodejs或C:\Users\<你的用户名>\AppData\Roaming\npm）
  2. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
  3. 在系统变量的「Path」中添加上述两个路径
  4. 重启所有终端和Visual Studio，再执行命令 npm install -D @azure/static-web-apps-cli

• 改用Node.js官方安装包
  跳过Visual Studio自带的Node.js安装，下载Node.js官网LTS版本安装包，安装时勾选「Add to PATH」选项，确保npm被正确加入环境变量。安装完成后重启终端和VS，再执行安装命令。

• 验证Node.js与npm可用性
  打开新的命令提示符或PowerShell，执行以下命令确认环境正常：

  node -v
  npm -v
  

  若能正常输出版本号，说明环境配置成功，回到Visual Studio终端重试SWA CLI安装。

• 在Visual Studio中指定Node.js路径

  1. 打开VS2022，依次点击「工具」→「选项」→「项目和解决方案」→「Web Package Management」→「External Web Tools」
  2. 将Node.js安装路径（如C:\Program Files\nodejs）添加到列表并调整至较高优先级
  3. 重启Visual Studio后重试发布操作

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