文章目录1. 插件开发最佳实践1.1 选择合适的插件形态函数式插件示例对象式插件示例类式插件示例1.2 插件命名规范1.3 插件的清理函数1.4 嵌套插件模式1.5 插件快照对比模式2. 服务开发最佳实践2.1 Service 的基本结构2.2 异步初始化2.3 服务的 mixin 模式2.4 关联类型（Associate）模式2.5 函数式服务2.6 服务的 provide/set/get 模式2.7 多依赖注入模式3. 事件系统使用模式3.1 选择合适的派发模式3.2 emit 模式3.3 parallel 模式3.4 bail 模式3.5 waterfall 模式3.6 serial 模式3.7 事件过滤模式3.8 一次性事件3.9 内置事件的使用internal/service 事件internal/status 事件internal/update 事件（waterfall）4. 依赖注入模式详解4.1 声明式注入 vs 命令式注入4.2 声明式注入（数组形式）4.3 声明式注入（对象形式）4.4 命令式注入4.5 @Inject 装饰器类装饰器方法装饰器4.6 注入的继承4.7 响应式依赖5. 副作用管理最佳实践5.1 为什么需要 Effect5.2 四种 Effect 形式对比5.3 Generator Effect 模式5.4 异步 Effect 模式异步函数形式异步 Generator 形式5.5 Effect 的提前终止5.6 Effect 标签与调试5.7 Effect 错误处理5.8 完全可释放原则6. 上下文隔离实战6.1 隔离的基本概念6.2 基本隔离示例6.3 共享标签模式6.4 隔离事件6.5 多服务隔离6.6 隔离的层级7. 配置管理与验证7.1 插件配置7.2 配置验证7.3 配置更新7.4 Intercept 配置拦截7.5 YAML 配置文件7.6 配置补丁（Patch）8. 日志服务使用指南8.1 日志服务概述8.2 基本用法8.3 日志级别8.4 直接使用 ctx.logger8.5 格式化字符串8.6 错误日志8.7 自定义导出器8.8 环形缓冲区8.9 控制台日志插件9. 定时器服务使用指南9.1 定时器服务概述9.2 ctx.timeout()9.3 ctx.interval()9.4 ctx.throttle()9.5 ctx.debounce()9.6 自动生命周期管理10. 测试最佳实践10.1 测试框架10.2 基本测试结构10.3 定时器测试10.4 快照测试模式10.5 类型声明扩展10.6 运行测试11. 错误处理与调试11.1 常见错误类型11.2 长堆栈追踪11.3 调试技巧查看 effect 树查看 Fiber 状态查看插件注册表查看事件监听器11.4 Fiber 状态检查12. 性能优化建议12.1 合理使用惯性锁12.2 避免过度隔离12.3 合理使用 Generator Effect12.4 事件监听器数量控制12.5 日志缓冲区大小12.6 插件加载顺序小结1. 插件开发最佳实践1.1 选择合适的插件形态Cordis 支持三种插件形态，选择合适的形态很重要：形态适用场景示例函数式简单的功能扩展，不需要注册服务事件监听、一次性初始化对象式需要配置 Schema、依赖声明等元数据可配置的功能模块类式 (Service)需要注册服务，提供可复用的 API数据库服务、缓存服务函数式插件示例适用于简单的副作用管理：// 来源：packages/core/tests/plugin.spec.tsconstroot