返回目录
开源项目开发者工具类新手

tldraw:用 React 构建无限画布应用的开源 SDK

tldraw 是一个面向 React 开发者的无限画布引擎与 SDK,提供绘图、白板、图形、箭头、贴靠、实时协作、自定义形状/工具/UI 组件等功能,并支持与 LLM 结合的 AI 画布交互,被 Google、Shopify、BlackRock 等团队用于构建画布类产品。

0 次阅读2026/08/19 发布
tldraw:用 React 构建无限画布应用的开源 SDK 来源图片

社区作者 · zZz

它解决什么问题

tldraw 提供功能完整的无限画布引擎,可作任何画布应用的基础。核心能力包括:自托管实时多人协作(通过 @tldraw/sync);压感绘制、几何图形、富文本、箭头、图形贴靠、边缘滚动、图片/视频支持和图片导出;可通过 Editor API 在运行时驱动画布;支持自定义形状、工具、绑定、UI 组件、副作用和事件钩子;具备画布原语,便于构建 LLM 的 AI 集成;基于 DOM 的渲染支持浏览器能呈现的任何内容,包括嵌入 YouTube、Figma、GitHub 等网站;兼容桌面、触屏、平板和移动设备浏览器。

官方还提供多种 Starter Kit,如多人协作、AI Agent、自动化工作流节点编辑器、画布 AI 聊天、图像处理管线、分支聊天、WebGL Shader 等。

— 本文由 AI 根据公开来源辅助整理,命令、版本与许可证请在使用前到原始页面复核。

安装 / 开始使用

快速开始:在 React 应用中执行

可复制命令
npm i tldraw 安装包

,然后使用 <Tldraw /> 组件:import { Tldraw } from 'tldraw'; import 'tldraw/tldraw.css'; export default function App() { return (<div style={{ position: 'fixed', inset: 0 }}><Tldraw /></div>); }。使用 Starter Kit 可运行 npx create-tldraw@latest。本地开发:需要 Node.js ^20.0.0。先全局安装 corepack:

可复制命令
npm i -g corepack

。克隆仓库后,安装依赖并启动开发服务器:

可复制命令
yarn 和 yarn dev

。开发服务器会在 localhost:5420 运行示例应用。从 5.1.x 起,发布的 npm 包还包含 DOCS.md 和 RELEASE_NOTES.md,可在 node_modules 中查看对应版本的文档与发布说明。

来源教程配图

tldraw
配图 1 · tldraw查看原图
教程配图
配图 2 · 教程配图查看原图
Star History Chart
配图 3 · Star History Chart查看原图

适用场景

构建自定义白板和无限画布应用
画图
图表和图形绘制
多人实时协作画布场景
AI Agent 读写与修改画布内容
自动化工作流节点编辑器和无代码平台
基于画布的 AI 聊天和图像标注交互