Cursor 的 Canvas 是干什么的：不是又一个编辑器窗口

2026-08-18

先把问题摆具体：你让 agent 跑一次依赖审计，或者让它把某张表按季度汇总一遍。它干完了，结果呢？如果结果是一坨长得要滚三屏的 markdown 表格塞在对话里，那你下周想再看一次，就只能翻聊天记录，或者重新问一遍。

Cursor 官方文档里的 canvas（cursor.com/docs/agent/tools/canvas）就是冲着这个位置来的。它容易被误读成”又开了一个可以写字的窗口”，但文档给它的定位不是编辑器窗口，而是产物的形态——文档的原话是让 Cursor 创建能渲染在聊天旁边的交互式 artifact，用 sections、stats、tables 这几类元素排布出一个独立的视图，而这个视图可以被重新打开、编辑、继续迭代。

下面沿文档描述的路径走一遍，途中把关键的入口名和限制条件标出来。文档只有这一页，凡是这一页没写的，我都会说没写。

一、canvas 是谁决定要建的

文档把这条路径拆成了四步，我按它的顺序复述：

Cursor 判断你这个任务适合用可视化或交互式的视图来呈现，或者你直接开口要一个；
Cursor 构建这个 canvas，并在你的对话里插入一条指向它的引用；
你审阅渲染出来的视图，或者切到 source 去改，或者让 Cursor 改；
Cursor 把这个 canvas 保存下来，之后你可以重新打开它，并用新数据重跑一次。

这里有两个点值得单独拎出来。

第一，触发权不完全在你手上。文档写的是”Cursor 决定”你的任务是否受益于这种视图，同时也留了你主动要的口子。它举的例子是 dashboard、analysis、audit、report 这几类请求——当这类请求出现，且 Cursor 认为 canvas 更合适时，结果就以 canvas 打开。至于它按什么规则做这个判断，官方文档没有说明这一点，我也不会去猜。你能确定的只有一件事：你可以直接要一个，这是文档写明的。

第二，产物是有 source 的。第 3 步里文档明确写了你可以”switch to the source”去调整，后面”Iterating on a canvas”一节又补了一句：小改动你也可以手动编辑 source code。所以 canvas 不是一张不可拆的渲染图，它背后有可编辑的源。但这个源具体是什么格式、存在仓库的哪个位置、会不会进 git，这一页官方文档没有说明。别按你对某个同类功能的印象去推——那是猜实现，不是文档。

二、产物存在哪：workspace 的 canvas list

第 4 步的”保存”是这一页里最实用的一句：每个 canvas 都会出现在你所在 workspace 的 canvas 列表里，你可以跳回过去的 canvas 而不必重跑。

这决定了它和”把结果贴在聊天里”的本质差别。聊天里的表格是一次性的，翻上去还在，但拿它没别的办法；canvas 是有身份的产物，能被再次打开，也能被要求带着新数据重跑一次。

文档给了三个打开入口：

入口	官方文档写明的做法
从 Cursor 的回复	Cursor 创建 canvas 时，回复末尾会出现一张卡片，点它打开
Command Palette	在命令面板里执行 Open Canvas，它归在 View 分类下
Agents Window	在 Agents Window 的新标签页菜单里直接开一个 canvas 标签页

三个入口都是官方文档白纸黑字写的名字，我原样抄过来了。要注意的是 Open Canvas 归在 View 下——命令面板里同名前缀的条目通常不止一条，知道它的分类能省点事。至于键盘快捷键、这些入口在窗口的什么位置、卡片长什么样，我们没有装过这个产品，也没有截图，这些一个字都不写。

三、分享：这里有四道闸，一道不过就用不了

“Sharing canvases”是这一页限制条件最密集的一节，也是最容易在团队里踩坑的地方。文档描述的机制是：分享时 Cursor 会把这个视图的一份实时快照上传，然后给你一个链接，队友在浏览器里打开就能看到同样的布局、图表和表格，不需要重跑 agent，也不用翻聊天记录。操作入口是 canvas 工具栏上的 Publish，用它发布或刷新一次分享；团队已发布的内容则从 dashboard 上的 Shared Canvases 浏览。

注意”上传快照”这四个字。文档用的动词是 upload，并且给出的是一个”队友在浏览器里打开”的链接；同一节接下来列的限制里，也确实有一条是隐私模式相关的。至于两者之间是不是因果，文档没有说明，我只把这两句并排放在这里。按文档写明的顺序，要用上分享，这几个条件都得满足：

计划：共享 canvas 只在付费计划上可用，免费账户不能创建分享（具体的计划名与价格请以官方定价页为准，本文不写这些）；
团队：因为每个分享都是团队可见的，所以你需要在一个团队里——文档特意补了一句，在团队里的 Pro 用户同样可以分享；
隐私模式：分享要求当前的隐私模式允许数据存储，文档明确写了 Legacy Privacy Mode 会阻止它；
组织开关：团队管理员可以在 team settings 的 Shared Canvases 一项里，把整个组织的共享 canvas 关掉。

最后这条尤其值得记住。如果你在公司账号下发现分享死活用不上，先别怀疑自己的计划——管理员那一侧有一个组织级开关，它的位置文档写明是在 team settings 下的 Shared Canvases。同样，如果你所在的组织出于合规要求走的是不允许数据存储的隐私模式，那么分享这条路在文档口径下就是关着的，这不是 bug。

第三条和第四条放在一起看，对合规岗位有一个直接可用的事实：按文档口径，共享 canvas 这一能力同时受隐私模式和组织级开关约束，两处任意一处不放行，它就用不了。文档只写了这两个约束各自存在，没有解释它们为什么被这样设置，我也不替它编理由。这份快照具体存多久、链接能不能撤回、有没有访问范围的更细控制，这一页官方文档没有说明，需要的话得去看隐私与团队管理相关的文档，别在这里想当然。

四、改它：文档建议你别用手改

“Iterating on a canvas”一节的四条建议，方向出奇地一致——优先让 Cursor 改，而不是自己动手：

布局不对，就告诉 Cursor 你要改成什么样，而不是手动去编辑；
数字看着旧了或不对，就让 Cursor 重跑背后那个查询，或者让它把过程摊开给你看（“show its work”）；
大改就直接 revert 掉，把要求说详细些重新提一遍——文档自述这样通常比用一连串小的追问去一点点挪要快；
只有小修小补，才建议你手动去编辑 source code。

第二条是我认为这一节里信息量最大的一句：canvas 里的数字背后是有一个可重跑的来源的，不是被固化进渲染结果里的死数。这和第一节第 4 步”用新数据重跑”是同一件事的两个说法。所以当你看到一个上周生成的 dashboard，正确的动作不是重新描述一遍需求，而是让它重跑。

第三条的”通常更快”是文档自己的说法，我照实标成文档自述。我们没有对这一点做过任何验证，也不会替它下结论。

五、把产物形状固定下来：canvas + skills

这一页的最后一节把 canvas 接到了 skills 上：常用的 canvas 工作流可以打包成一个 skill，让 Cursor 每次都产出一致的布局。文档列了一个 canvas skill 通常包含的四类内容：

trigger description：让 Cursor 知道什么时候该动用它，文档举的例子是 “quarterly revenue report”、“dependency audit” 这类描述；
布局说明：定义这个 canvas 该包含哪些 sections、stats、tables；
数据来源与查询：Cursor 该跑什么来把视图填满，文档举的是 SQL 查询、API 调用或 shell 命令；
格式规则：单位、日期区间、排序方式这些。

skill 一旦就位，文档写的是一句短提示就够了：重新生成这个 canvas，带上新数据；而且团队里每个用这个 skill 的人拿到的输出形状是一样的。

第三条要留个心眼：数据来源里明明白白包含 shell 命令。也就是说一个被固化下来的 canvas skill，可能携带着会在你这边执行的命令和会打到你数据库上的查询。这一页文档没有讲这里的权限边界怎么划——那属于 Cursor 权限与 skills 相关文档的范围，不在这一页。团队内共享这类 skill 之前，值得按你们自己的规矩过一遍它带的查询和命令。这是通用做法，不是这一页官方文档的内容。

收个尾

把这一页压成一句话：canvas 改变的不是你怎么看结果，而是结果以什么形态存在——它有独立的视图和可编辑的 source，进 workspace 的 canvas 列表，能重新打开、能带新数据重跑、能（在几道闸都通过时）发布成团队可见的链接，还能用 skills 把形状固定住。

也把它没告诉你的说清楚：Cursor 依据什么判断该用 canvas、source 的具体格式与存放位置、共享快照的留存与撤回、canvas skill 执行查询与命令时的权限边界——这一页都没有写。缺的这几块，只能等官方文档补，别靠推测填。该产品迭代频繁，文中涉及的入口名与设置项随版本变动，以官方文档最新内容为准。

本文依据 Cursor 官方文档（cursor.com/docs 与 cursor.com/help）于 2026-08-18 的公开内容整理。该产品闭源，本文只复述官方文档写明的机制，不推断其内部实现； 我们没有对文中涉及的功能做过实测，因此不涉及界面外观、操作手感与运行速度的任何描述。该产品迭代频繁，文中涉及的设置项与命令随版本变动，请以官方文档最新内容为准。本文不涉及订阅价格、额度与模型清单，相关信息请以官方定价与模型说明页为准。

安全与合规相关做法请结合自身环境评估，本文不构成安全方案建议。