cloudflare/workers-sdk
6 articles
前置知识
- ›了解 monorepo 的基本概念
- ›具备 pnpm / npm workspaces 的基础知识
- ›熟悉 Turborepo 或类似的构建编排工具
01
深入解析 Cloudflare Workers SDK：架构总览与代码库导航
全面介绍 workers-sdk monorepo 的结构：packages 如何在 pnpm 和 Turborepo 下组织，从 Wrangler 到 Miniflare 再到 workerd 二进制文件的依赖关系图，以及将运行时依赖压缩到最少的非常规打包策略。
02
Wrangler 的启动机制：命令系统与 CLI 解析器
深入剖析 Wrangler 的启动流程——从二进制 shell 脚本到基于 yargs 构建的声明式命令注册系统，以及为每个命令注入横切关注点的 handler 包装器。
03
DevEnv 控制器模式：`wrangler dev` 如何编排本地开发环境
一个事件驱动的控制器编排层，通过类型化消息总线协调配置监听、esbuild 打包、本地/远程运行时以及 HTTP 代理的协同运作。
04
深入 Miniflare：插件架构与 workerd 集成
Miniflare 通过一套由 28 个独立注册模块组成的插件系统来编排 workerd 子进程，每个模块声明经 Zod 验证的选项并生成 workerd 服务配置，从而模拟 Cloudflare Workers 运行时。
05
从源码到边缘网络：构建系统与部署流水线
Wrangler 的部署路径将 TypeScript Worker 源码转化为多部分表单上传——经由带有自定义 Workers 专属插件的 esbuild、模块收集、FormData 构造，以及处理路由发布和配置差异对比的 deploy 函数。
06
Vite 插件与配置系统：两套接口，同一个运行时
@cloudflare/vite-plugin 通过独立的插件管道提供一流的 Vite 集成，底层使用与 wrangler dev 相同的 Miniflare 核心——两个工具通过 @cloudflare/workers-utils 共享统一的配置层。