.NET 5下Blazor项目使用dotnet watch排除wwwroot时报Exclude属性不识别错误
报错来源
.NET 5 配套的 MSBuild 16.8 版本中,<Watch> MSBuild项不支持在元素上直接声明Exclude属性,因此会抛出MSB4066: The attribute "Exclude" in element <Watch> is unrecognized的编译错误。
参考官方文档中提到的直接在<Watch>标签编写Exclude的写法,是.NET 6及以上版本才引入的dotnet watch语法规则,不属于.NET 5的兼容范围。
同时之前设置的Include=""存在逻辑问题:空Include会直接清空所有默认纳入监听的文件条目,导致dotnet watch完全失效,无法监听C#、Razor等业务代码的变更。
正确配置写法
.NET 5 中调整dotnet watch的监听范围,是通过对Watch项集合的Add/Remove操作实现的,不需要手动设置空的Include值。
针对排除wwwroot目录所有文件、避免修改静态文件触发项目重建的需求,仅需在可执行启动项目的csproj中添加如下配置即可:
<ItemGroup> <!-- 从dotnet watch默认监听清单中移除wwwroot下的全部文件 --> <Watch Remove="wwwroot\**\*" /> </ItemGroup>
该配置会完全保留dotnet watch默认纳入监听的代码类文件(.cs、.razor、项目配置json等),仅剔除wwwroot路径下的静态文件条目,不会触发无意义的项目重建流程。
注意:该配置仅需要加在运行dotnet watch命令的可执行启动项目的csproj中即可,不需要修改类库项目的配置——dotnet watch会自动纳入关联类库中的代码文件到监听范围。
生效验证
配置完成后,可通过环境变量输出当前所有监听文件清单,验证规则是否生效:
- Windows CMD环境:
set DotNetWatchList=1 && dotnet watch run - PowerShell环境:
$env:DotNetWatchList=1; dotnet watch run
启动后控制台会打印完整的监听文件列表,确认wwwroot下的文件不在列表内即可。修改Razor、C#代码时依然会正常触发热更新,修改wwwroot下的静态资源不会触发重建。
内容的提问来源于stack exchange,提问作者maloo

