入门

欢迎来到 Effect 指南。如果你是 Effect 新手，请先从 入门引导 开始，该章节会按顺序介绍核心概念。这些指南会更详细地 讲解每个主题，你也可以在动手构建时把它们当作参考资料使用。

如何使用这些文档

文档按顺序组织，从基础开始，逐步推进到更进阶的主题。这样你就可以在构建 Effect 应用时 一步步跟着学。不过你也可以按任意顺序阅读，或者直接跳到与你具体使用场景相关的页面。

你可以使用页面顶部的版本选择器在 Effect 的不同版本之间切换。

为方便在页面内导航，屏幕右侧提供了目录。你可以借此轻松跳转到页面的不同小节。

指南栏目

这些指南按领域分组：

• 错误管理 指南涵盖带类型的错误、回退与重试。
• 并发 指南涵盖 Fiber、有界并行与竞速。
• 资源管理 指南讲解如何安全地获取与释放资源。
• Schema 指南涵盖数据的解析、校验与转换。
• 可观测性 指南涵盖日志、指标与追踪。
• 流式处理 指南展示如何构建带背压的数据管道。

要查阅每个模块的完整参考，请见 API 参考。

使用 LLM 编写代码

下面这篇文章介绍了如何将 Effect 与 LLM 结合使用：https://effect.website/blog/the-one-weird-git-trick-that-makes-coding-agents-more-effect-ive/

使用 LLM 时，将反馈回路优化到尽可能紧凑同样非常重要，其中可以包括编写契合你风格偏好与 模式的自定义 lint 规则。一个为 agentic coding 优化过的仓库示例见：https://github.com/mikearnaldi/accountability

优化反馈回路（以及总体上使用 Effect 时的开发者体验）的一个关键点是使用 Effect LSP 插件， 我们建议使用它最新的 “tsgo” 实现，见：https://github.com/Effect-TS/tsgo

加入我们的社区

如果你对任何与 Effect 相关的问题有疑问，欢迎加入中文社区微信群直接提问， 也可以在官方的 GitHub 仓库 上参与讨论。