.NET Core中如何按需编译并验证所有Razor视图？

云上老周

2026-5-25

我来帮你梳理下几种可行的方法，不管是在Visual Studio里操作，还是用CLI命令，都能满足你按需编译验证Razor视图的需求，另外也聊聊你提到的那款预览版工具：

在Visual Studio中编译验证Razor视图

开启实时编译验证：右键你的项目 → 选择「属性」→ 切换到「生成」标签页，找到「启用 Razor 视图编译」选项（ASP.NET Core 2.x及以上版本都有这个设置）。勾选之后，每次你构建项目（比如按Ctrl+Shift+B生成解决方案），Visual Studio都会同步编译所有Razor视图，任何语法错误、引用问题都会直接在错误列表里显示，不用等到发布阶段才发现问题。
手动触发全量编译：如果你只是偶尔需要验证所有视图，可以先执行「清理解决方案」（右键解决方案→清理），再执行「生成解决方案」，这样会强制重新编译所有视图，确保没有遗漏的错误。

使用CLI命令编译验证Razor视图

日常开发验证：dotnet build
在项目根目录打开终端，运行命令：
```
dotnet build
```
前提是你已经在项目的.csproj文件里添加了视图编译配置：
```
<PropertyGroup>
  <MvcRazorCompileOnBuild>true</MvcRazorCompileOnBuild>
</PropertyGroup>
```
这个命令会编译项目代码和所有Razor视图，错误信息会直接输出在终端里，方便快速排查。
发布级验证：dotnet publish
如果你想模拟发布阶段的严格编译，运行：
```
dotnet publish -c Release
```
这个命令会执行完整的发布流程，包括Razor视图的预编译，能验证视图在生产环境下的兼容性，比如是否有未引用的模型、语法漏洞等。

关于预览版Microsoft.AspNetCore.Razor.Tools工具

这款预览阶段的官方工具目前确实没有完整的官方文档，但它的定位是提供更精细化的Razor视图编译控制。你可以先通过NuGet将它安装到项目中，然后尝试在终端运行dotnet razor compile命令（可以加上--help参数查看可用选项，比如指定视图目录、输出路径等）。不过因为是预览版本，功能可能存在不稳定的情况，建议先在测试环境试用，同时留意官方后续的文档更新。

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