Blazor 操作浏览器本地存储需通过 JS Interop，WASM 和 Server 均依赖此机制；推荐使用 Blazored.LocalStorage 封装库，支持强类型异步操作；也可手动实现 JS Interop；localStorage 持久共享，sessionStorage 仅限当前标签页；注意字符串限制、容量上限及敏感信息安全。
Blazor 操作浏览器本地存储，核心是借助 localStorage 或 sessionStorage 这两个 Web Storage API。Blazor WebAssembly（WASM）不能直接访问浏览器存储，必须通过 JavaScript 互操作（JS Interop）调用；而 Blazor Server 虽然运行在服务端，但也能通过 JS Interop 与客户端浏览器通信完成操作——所以两种模型都依赖 JS 互操作，只是实现方式略有差异。
用 Blazored.LocalStorage 快速上手（推荐）
这是最常用、最稳定的第三方封装库，屏蔽了 JS 互操作细节，提供强类型、异步友好的 C# 接口：
- 安装包：
dotnet add package Blazored.LocalStorage - 在
Program.cs中注册服务：builder.Services.AddBlazoredLocalStorage(); - 在组件中注入使用：
@inject ILocalStorageService LocalStorage - 存取示例：
await LocalStorage.SetItemAsync("theme", "dark");var theme = await LocalStorage.GetItemAsync("theme");
手动 JS Interop 方式（无第三方依赖）
适合轻量场景或想完全掌控流程的项目：
- 在
wwwroot/index.html的或底部添加简易 JS 工具函数：window.loadFromStorage = (key) => localStorage.getItem(key); - 在 Blazor 组件中注入
IJSRuntime：@inject IJSRuntime JSRuntime - 调用示例：
await JSRuntime.InvokeVoidAsync("saveToStorage", "userId", "123");var userId = await JSRuntime.InvokeAsync("loadFromStorage", "userId");
区分 localStorage 和 sessionStorage
两者 API 完全一致，关键区别在生命周期和作用域：
- localStorage：数据持久保存，关闭浏览器也不丢失，同一域名下所有标签页共享
- sessionStorage：仅限当前标签页，关闭该标签页即清除，适合临时状态（如表单草稿、导航历史）
- Blazored.LocalStorage 默认操作 localStorage；如需 sessionStorage，可额外配置或手动 JS 调用
sessionStorage.setItem
注意安全与适用边界
本地存储不是保险柜，有明确限制：
- 只支持字符串值，存对象需先
JsonSerializer.Serialize，读取后反序列化 - 容量约 5–10 MB（因浏览器而异），不适合存大文件或大量二进制数据
- 敏感信息（如 token、密码）不建议明文存 localStorage；生产环境推荐用 HttpOnly Cookie + 后端验证，或启用
ProtectedBrowserStorage（仅 Server 端支持） - Blazor WASM 在私密/无痕模式下，localStorage 数据会在最后一个私密标签关闭时自动清空
基本上就这些。选 Blazored.LocalStorage 是多数项目的省心之选，手动 JS Interop 更适合教学、调试或极简集成。不需要引入复杂方案，就能稳稳把用户偏好、界面状态、轻量缓存落进浏览器里。
