Visual Studio编译Blazor项目遇MSB3073错误：npm run build-css退出码1

以下是针对性的排查和解决步骤：

• 确认Node.js与npm环境正常
  打开终端（CMD/PowerShell），执行node -v和npm -v，确保两者都能返回有效版本号。如果未安装，下载对应LTS版本的Node.js（包含npm）完成安装；如果版本过低，建议升级到项目要求的版本。

• 手动执行命令查看详细错误
  到项目根目录（存在package.json的文件夹）打开终端，直接运行npm run build-css。VS的错误提示仅显示退出码，手动执行能看到具体失败原因——比如Sass语法错误、文件路径不存在、依赖包缺失等，这是定位问题的核心。

• 重新安装npm依赖

  1. 删除项目根目录下的node_modules文件夹和package-lock.json（或yarn.lock）文件
  2. 在终端执行npm install，重新拉取所有依赖包

• 检查build-css命令配置
  打开package.json，查看scripts字段中的build-css具体命令。比如常见的sass 源文件路径 输出文件路径格式，要确认源文件是否存在、相对路径是否正确（路径以package.json所在目录为基准）。

• 修正VS命令执行工作目录
  打开项目的.csproj文件，找到调用npm run build-css的<Exec>节点，检查WorkingDirectory属性是否指向package.json所在目录。例如：

  <Exec Command="npm run build-css" WorkingDirectory="$(ProjectDir)" />
  

  若路径错误，修改为正确的目录路径。

• 清理项目缓存并重建

  1. 关闭Visual Studio
  2. 删除项目目录下的bin和obj文件夹
  3. 重新打开项目，执行Build -> Clean Solution，再执行Build -> Rebuild Solution

• 更新相关npm包
  如果是依赖包版本冲突或bug导致的问题，尝试更新相关包。比如使用Sass时执行npm update sass，或直接执行npm update更新所有包到兼容版本。

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