NavigationManager 是 Blazor 唯一官方编程式导航方式，需 @inject 注入，调用前应空值检查；NavigateTo 支持 forceLoad（整页刷新）、replace（替换历史）；路由参数自动绑定需同名且类型匹配，查询字符串须手动解析；LocationChanged 事件需显式订阅/反订阅防泄漏。
Blazor 中的页面跳转不依赖第三方库，NavigationManager 是唯一官方支持的编程式导航方式，它轻量、可靠，但有几个关键行为必须提前确认——比如默认不刷新页面、不触发服务端重载、参数不会自动解析查询字符串。
如何在组件中安全注入并调用 NavigationManager
不能直接 new 实例，必须通过 @inject NavigationManager NavigationManager 注入。注意变量名大小写敏感，常见错误是写成 navigationManager 或 navManager 导致编译失败或空引用异常。
调用跳转前建议加空值检查（尤其在生命周期方法中）：
-
NavigationManager在OnInitialized阶段可能尚未完全就绪，避免在此处直接调用NavigateTo - 若需初始化后立即跳转（如权限校验），改用
OnAfterRenderAsync+firstRender标志位控制一次执行 - 跳转路径建议用绝对路径（如
"/login"），相对路径（如"login"）易受当前 URL 影响导致跳错
NavigateTo 的三个关键参数怎么选
NavigateTo(string uri, bool forceLoad = false, bool replace = false) 这三个参数直接影响浏览器行为和用户体验：
-
forceLoad: true：强制整页刷新，仅用于跳转到非 Blazor 管理的页面（如静态 HTML、ASP.NET Core MVC 页面），在纯 Blazor 应用中极少需要 -
replace: true：替换当前历史记录项，用户点浏览器“后退”时不会回到该页——适合登录成功后跳主页、404 后跳首页等场景 - 省略所有可选参数即为默认行为：单页内路由切换，URL 变、DOM 替换、不刷新、保留历史栈
示例：NavigationManager.NavigateTo("/profile/123", replace: true) 会跳转且抹除上一页记录。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
为什么跳转后路由参数没绑定到 [Parameter] 属性
这是最常被忽略的细节：路由参数（如 @page "/user/{id:int}" 中的 {id}）只绑定到同名 [Parameter] 属性，且类型必须严格匹配（int 不能写成 string），而查询字符串（如 ?q=abc&sort=date）完全不会自动绑定。
处理查询字符串要手动解析：
- 用
NavigationManager.ToBaseRelativePath(NavigationManager.Uri)提取路径部分 - 再用
QueryHelpers.ParseQuery()解析完整 URL 中的查询参数 - 别在
OnInitialized里直接读NavigationManager.Uri，此时可能还是旧地址；应在OnParametersSet或LocationChanged事件回调中处理
监听 URL 变化时最容易内存泄漏
NavigationManager.LocationChanged 是事件委托，必须显式取消订阅，否则组件销毁后仍持有引用，造成内存泄漏。
正确写法：
- 在
OnInitialized中订阅：NavigationManager.LocationChanged += HandleLocationChanged - 实现
IDisposable接口，在Dispose方法中反订阅：NavigationManager.LocationChanged -= HandleLocationChanged - 如果组件是无状态的（如纯展示页），其实不需要监听——路由参数变化会自动触发
OnParametersSet
复杂点在于：LocationChanged 触发时机早于参数绑定，所以不要指望在该事件里直接读 [Parameter] 值。
