Razor Page中asp-page标签助手无法正确渲染为HTML超链接问题

数据老陈

2026-9-27

ASP.NET Core Razor Pages asp-page标签未渲染问题解决方案

检查标签助手导入配置
请确认项目根目录或Pages目录下的_ViewImports.cshtml文件包含以下导入语句：
```
@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers
```
该语句是启用所有内置ASP.NET Core标签助手的必要配置，缺失时所有asp-前缀的标签属性都不会被渲染引擎处理，会直接输出原始的HTML代码。
检查页面文件属性
确认当前编写锚标签的Index页面后缀为.cshtml，是标准的Razor页面而非静态HTML页面，只有Razor页面会触发标签助手的渲染逻辑。
检查路径匹配规则
确认Pages/Contacts/Create.cshtml文件存在，且该页面头部的@page指令未配置特殊的自定义路由，若配置了自定义路由需要同步调整asp-page的属性值匹配规则。
检查拼写规则
确认asp-page属性名拼写无误，大小写符合要求，属性值以/开头的路径规则和你当前的写法匹配，属于Pages根目录的绝对路径规则。