实践

REST 资源命名与错误结构统一实践(2025)

REST 资源命名与错误结构统一实践(2025)统一的资源命名与错误结构是 API 可用性的基础。一、资源命名名词复数:`/users`、`/orders`;避免动词化路径。层级关系:`/users/{id}/orders` 表示归属关系。过滤与排序:使用查询参数,如 `?status=active

Rslib 库构建:输出格式与模块联邦实践

引言Rslib 为库构建提供统一工具链与一致心智模型,支持多格式产出与模块联邦,并复用 Rsbuild 的大部分配置与生态。核心能力(已验证)多格式输出:支持 ESM、CJS、UMD 与 Module Federation,一套配置覆盖多场景,适合跨框架复用。来源:Rslib 发布说明与输出格式文档

Rspack 懒编译与持久化缓存实践指南

引言Rspack 面向大型项目持续演进:懒编译可显著提升 dev 启动速度;1.2 引入实验性持久化缓存,1.4 默认启用,进一步缩短重复构建耗时。版本进展(已验证)懒编译:在新版本中提供 lazy compilation 能力,显著提升大型项目的 dev 启动速度。来源:Rsbuild Relea

Rspress 插件开发:容器语法与 TypeDoc 集成实践

引言Rspress 的插件机制支持 Node 端与浏览器运行时扩展,可用于增强 Markdown/MDX 编译、路由、全局组件与主题定制。插件实践(已验证)容器语法插件:`@rspress/plugin-container-syntax` 支持在 Markdown/MDX 中使用 `::: cont

Rspress 文档站实践与 MDX 支持

引言Rspress 基于 Rsbuild/Rspack 的静态站点生成器,支持 MDX 内容、国际化与多版本文档,适合搭建高性能文档站与博客。核心能力(已验证)MDX 支持:基于自研 `@rspress/mdx-rs` 提供编译能力,相比 JS 版本性能提升 10 倍以上。来源:Rspress“使用

Rust Tokio Tracing 与指标观测实践(2025)

Rust Tokio Tracing 与指标观测实践(2025)Tokio 提供高性能异步运行时,Tracing 为异步任务提供结构化观测能力。一、Tracing 与结构化日志span/event:定义关键路径与事件,统一上下文与标签。层与采样:通过层级与采样控制日志体量与成本。二、指标与导出指标:

Rust高性能服务开发与异步Tokio实践

使用 Rust + Tokio 构建高性能服务,合理配置运行时与并发模型,结合 Hyper/Actix、度量与优化方法,提供可验证的实践清单。