news 2026/8/28 9:19:19

Excalidraw 手绘风协作虚拟白板:3 条命令跑起来

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Excalidraw 手绘风协作虚拟白板:3 条命令跑起来

Excalidraw 手绘风协作虚拟白板:3 条命令跑起来

【免费下载链接】excalidrawVirtual whiteboard for sketching hand-drawn like diagrams项目地址: https://gitcode.com/GitHub_Trending/ex/excalidraw

Excalidraw 是一款开源虚拟白板,所有线条都带手绘草图质感,支持多人实时协作,协作链路端到端加密。适合三类人:要画系统图的开发者、要写互动板书的教师、要出低保真线框图的产品经理。装到本地后开箱即用,本文带你从克隆到画出第一张图。

两个离不开白板的场景

远程头脑风暴。会议里每人对着同一块画布,想法落笔即同步,不用来回截图传文件。讨论完直接导出 PNG 丢进会议纪要,或分享一个只读链接让没参会的人看结果。

课程互动板书。教师把白板投到大屏,学生实时看到推导过程;讲到哪改到哪,数学公式、时间线、流程图都能直接画,抽象内容当场变成可视化。

核心能力速览:这块虚拟白板能做什么

能力一句话说明
🎨 无限画布 + 手绘渲染画布无边界,线条自带轻微抖动,图表像白板上画出来的
🤝 实时协作多人同时编辑同一场景,修改秒级同步,数据端到端加密
🔒 本地优先存储自动保存到浏览器本地,断网也能继续画
📤 多格式导出PNG、SVG、复制到剪贴板,或存为开放的.excalidrawJSON 文件
形状库常用图标、组件存进库,需要时一键调出

克隆仓库并启动开发服务器

前置条件只有一个:Node.js 18 以上(yarn 随项目锁定为 1.22)。下面分两组命令,第一组克隆并装依赖,第二组启动开发服务器:

git clone https://gitcode.com/GitHub_Trending/ex/excalidraw cd excalidraw yarn install
yarn start

启动后浏览器会自动打开http://localhost:3000,看到带引导提示的欢迎界面即代表环境就绪。

默认端口在excalidraw-app/vite.config.mts里通过环境变量VITE_APP_PORT控制(默认 3000),被占用时改这里即可,不用动其他配置。

日常高频操作与快捷键速查

日常画图中用得最勤的几个组合键:

  • Ctrl+D复制选中元素,Ctrl+G组合、Ctrl+Shift+G取消组合
  • 按住空格拖动平移画布,Ctrl+0重置缩放,Shift+1让全部内容适屏
  • ?随时调出完整快捷键列表,源码在packages/excalidraw/actions/shortcuts.ts,想加新快捷键直接改这个文件

冷门但实用的功能

  • Alt+/(Mac 为Option+/)打开 "Stats for nerds" 统计面板,能看到场景元素数、画布宽高和存储占用,排查大图卡顿前先来这里看一眼
  • Alt+R切换 View mode(只读模式),画布不可编辑时渲染负担最小,适合只看不画的场景
  • Q锁定当前工具:连续画 10 个矩形不用每画完一个就回工具栏点一次
  • Shift+1/Shift+2/Shift+3分别是整体适屏、当前视口适屏、选中元素适屏三档定位

角色工作流:拿到工具后的前 30 分钟

开发者。前 10 分钟用矩形和箭头画出服务拓扑,箭头默认能吸附到形状边缘,拖动框体连线不跑偏;接着把重复的服务框Ctrl+D复制几个;最后导出 SVG 贴进设计文档。如果想把白板嵌进自家工具,仓库里的dev-docs/docs/@excalidraw/excalidraw/目录有完整的集成文档。

教师。前 15 分钟用文本和菱形摆出知识框架,讲到的分支直接往旁边延伸;Alt+R切到只读模式做课堂演示,防止误触改乱板书;课后导出 PNG 归档。

产品经理。用矩形快速铺线框图,Q锁定矩形工具连铺十几个模块;配色用色板统一区分模块归属;需求评审时开协作链接,让评审人直接在图上圈改。

踩坑速查:4 个常见问题

端口 3000 被占用,启动后打不开页面

  • 原因:本机已有别的开发服务占着 3000 端口
  • 解法:在项目根目录.env中设置VITE_APP_PORT=3001再启动

yarn install 失败或依赖版本冲突

  • 原因:本地缓存或残留的 node_modules 状态脏了
  • 解法:删除node_modules目录后重新yarn install,仍失败再清 yarn 缓存

本地启动后协作功能不可用

  • 原因:实时协作依赖独立的 collab 服务,纯本地开发不会自动连上
  • 解法:单独搭建 collab 服务,或直接用仓库自带的 Docker 镜像自托管

元素多了画布明显变卡

  • 原因:场景内元素数量超出流畅阈值
  • 解法:Alt+/看元素数,合并重复元素、清掉无用历史,演示时切Alt+R只读模式

画下你的第一张图

Excalidraw 把"快速画出来给别人看"这件事做到了三步以内:克隆、安装、启动。它是 MIT 协议的开源项目,画完第一张图后,建议顺手把常用的几个框存进形状库——第二次画图时你会感谢这个习惯。打开终端,3 条命令之后你就能看到自己的画布。

【免费下载链接】excalidrawVirtual whiteboard for sketching hand-drawn like diagrams项目地址: https://gitcode.com/GitHub_Trending/ex/excalidraw

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/8/28 9:16:46

蓝桥杯国赛冲刺:高效每日一题的系统性训练方法

1. 项目概述与核心价值 “每日一题冲刺国赛”,这几乎是每一位踏上蓝桥杯竞赛征途的选手都绕不开的经典备考策略。它听起来简单,甚至有些老生常谈,但真正能将其价值发挥到极致的选手,往往才是最后站在领奖台上的那批人。我参加过几…

作者头像 李华
网站建设 2026/8/28 9:13:01

数学建模竞赛实战指南:从破题到论文的全流程策略与工具链

1. 项目概述:一次数学建模竞赛的复盘与沉淀2021年10月18日,这个日期对我而言,远不止是日历上的一个普通节点。它标志着我与团队刚刚结束了一场历时数日的数学建模竞赛,从高度紧张的封闭式头脑风暴、代码鏖战,到最终提交…

作者头像 李华
网站建设 2026/8/28 9:10:57

端侧Agent模型LFM2.5-2.6B部署实战:工具调用与量化优化

这次我们来看一个端侧 Agent 模型:LFM2.5-2.6B。它的重点不是参数规模有多大,而是能不能把 Agent 能力塞进手机、平板、边缘盒子这类资源受限设备里,同时还能完成工具调用、任务规划、意图识别这些偏“智能体”的活。 先说结论:如…

作者头像 李华
网站建设 2026/8/28 9:10:12

llm-anthropic 0.27升级指南:适配Anthropic Python SDK v1.0.0的排查思路

最近我在用 llm 命令行工具批量整理项目文档,原本稳定的 Claude 调用突然开始报错,错误信息指向 anthropic 的 Python 库——新代码和旧插件之间的接口已经对不上了。随后看到 llm-anthropic 发布了 0.27 版本,核心就是适配 anthropic 的…

作者头像 李华
网站建设 2026/8/28 9:09:30

基于模块图的RAG系统:从黑盒到白盒的可视化、可编排架构实践

简介:检索增强生成(RAG)技术通过结合信息检索与大语言模型,有效提升了AI问答的准确性与知识实时性。其核心原理在于将外部知识库向量化,检索出与用户查询最相关的文档片段,并作为上下文输入给大模型&#x…

作者头像 李华
网站建设 2026/8/28 9:08:07

生成式AI完整入门指南:21节开源课程带你从零构建AI应用

生成式AI完整入门指南:21节开源课程带你从零构建AI应用 【免费下载链接】generative-ai-for-beginners 21 Lessons, Get Started Building with Generative AI 项目地址: https://gitcode.com/GitHub_Trending/ge/generative-ai-for-beginners generative-a…

作者头像 李华