VectorCraft 图层面板终极指南：三关练出整理复杂插画的肌肉记忆
项目地址: https://gitcode.com/gh_mirrors/ve/vectorcraft VectorCraft 是一款用纯 Rust 编写的开源矢量插画软件，而图层面板是它向 Illustrator 用户致敬最深的地方：图层、子图层、组和普通对象各占一行，按层级缩进嵌套显示，眼睛列、锁列、目标圆圈、选择列一应俱全。本文不按"面板有哪些按钮"的说明书方式讲起，而是模拟一次真实事故——你接到了一个三层嵌套、四百个对象全堆在"图层 1"里的 VectorCraft 文件，要把它变成自己也能长期维护的结构。全程分三关：第一关读懂面板每一行的构造，第二关把眼睛列和锁列的手势练成条件反射，第三关用合并、打平这类批量命令完成交付前的图层整理。
第一关：读懂这个"事故现场"
每一行由哪七样东西拼成
打开文件，先别急着改。对着 crates/ui-egui/src/panels/layers.rs 实现的这一排元素，从左到右认一遍：
- 👁️ 眼睛列——控制可见性，也是快捷手势最密集的一列；
- 🔒 锁列——控制锁定状态；
- 图层色条——每个图层有专属颜色，子图层和组的色条更细，一眼分清层级；
- 展开三角形——点开或收拢一行里的嵌套内容；
- 缩略图 + 名称——双击名称直接重命名，双击行内其他位置打开图层选项；
- 目标圆圈 ○——把外观类命令指向这一行；
- 选择列 ☐——点它选中该行的图稿，选中后这里显示该行图层颜色的小方块。
点一下任意一行，它就成为高亮行，其所在图层同时变成当前图层——之后画的东西都进这一层。Shift+点击选中一段连续行，Ctrl/Cmd+点击追加或取消单行，面板命令默认作用在高亮行上。面板底部的 ≡ 菜单和按钮条里还有几个常用件：定位对象（在几百行里找到选中对象所在的那一行）、过滤器按钮（按对象类型和图层状态筛行），以及 Panel Options…（"仅显示图层"、定位选中对象、行高与缩略图开关，实现见 crates/ui-egui/src/dialogs/layers_panel_options.rs）。对象多到眼花时，勾上"仅显示图层"，组与对象行立刻让位，面板清爽一大半。
三层收纳格：图层、子图层、组各管一段
"对象太多"的根治办法在 VectorCraft 里叫子图层（Sublayer）——图层里面套图层，像文件夹一样把同类对象收进同一格。三条路都能建：
- 按 Ctrl/Cmd+L（菜单 Window › Layers › New Layer…）新建图层；选中某图层再新建，新图层会成为它的同级兄弟图层；
- 选中一个图层后点 New Sublayer…，就在该图层内部、它现有内容的上方开出一格；
- 选中多个散落对象，点 Collect in New Layer（收集到新图层），一键把它们按原位置归拢进一个新图层，这是收拾事故现场最快的动作。
组（Group）则是更"扁平"的容器：它不占独立的色条和层级色板，只把成员打包成一个可整体移动的行。习惯上：跨页、跨阶段的分区用图层，分区内的模块用子图层，临时打包几个对象用组即可。
把参考素材关进模板图层
贝塞尔控制点、客户原稿、临摹底图——这些东西画的时候要看，但绝不能被点到，更不该混进导出文件。把放着它们的图层标记为模板（Template）即可：图层自动锁定、其中的图片淡化到 50%，并且不参与打印和导出；取消模板则自动解锁并恢复显示。面板里模板图层的眼部位置会换成一个专属标记，不会再被误点。命令是 crates/engine/src/cmd/layerpanel.rs 里的 layer.template，或直接在图层选项里勾选 template。
💡 经验值：参考图层放最底层、命名带
REF-前缀。以后翻旧文件，光看色条就知道哪层不用碰。
第二关：手势比菜单快十倍
VectorCraft 的图层面板几乎每个列位都藏着修饰键手势，熟练后基本不用打开菜单（对应命令实现见 crates/engine/src/cmd/layer.rs，核心是支持 visible、locked、template、printable 等参数的 layer.setProps）。
眼睛列的四个组合键
| 手势 | 效果 | 命令 |
|---|---|---|
| 普通点击 | 切换该行可见性 | layer.setProps {visible} |
| 按住眼睛向下拖 | 沿途所有行设为同一状态，一步撤销 | layer.setProps |
| Alt+点击眼睛 | 隐藏其他所有顶层图层（Hide Others）；它们已全隐藏时再点一次，全部显示（Show All Layers） | layer.hideOthers / layer.showAll |
| Ctrl/Cmd+点击眼睛 | 本层在"预览/轮廓"（Preview/Outline）间切换，快速检查形状 | layer.setProps {preview} |
| Ctrl/Cmd+Alt+点击眼睛 | 其他图层转轮廓、本层保持预览；其他已全轮廓时则全部恢复预览 | layer.outlineOthers / layer.previewAll |
"改错图层"的高发场景——在几百个重叠对象里只看得见自己正在改的那一层——就靠 Alt+点眼睛解决：其余图层瞬间安静，再点一次全部回来。
锁列与隔离：让工具只能碰到你想改的
锁列的手势与眼睛列对称：普通点击切换锁定；Alt+点击锁执行 Lock Others（锁定其他所有顶层图层并解锁本层，全锁时再点一次则 Unlock All）；锁列同样支持按住向下拖批量设锁。调试完别急着解锁——锁住无关图层再撤销几轮，比"小心点"可靠得多。
目标圆圈：把"外观"当成可搬运的东西
点某行的目标圆圈，就是告诉软件：接下来 appearance.*、effect.*、transparency.* 这些不带 ids 的命令作用于这一行（图层、组或对象都适用）。更强的玩法是拖拽：把一个圆圈拖到另一个圆圈上，填充、描边、效果、不透明度整套外观就"搬"了过去（appearance.transfer，Alt+拖拽则是复制外观）；拖到底部垃圾桶，清空目标的外观。做一套统一卡片时，设计好第一张，圆圈拖拽刷其余九张。
剪切蒙版：用图层顶部对象裁出轮廓
选中目标图层（或组），点面板底部的 Make/Release Clipping Mask 按钮（命令 layer.clippingMask.toggle）：该图层内最顶部的对象——路径、复合路径或文字——会丢填充、移到最底部，把下面的内容裁切在它自己的形状里；之后往上添加的新图稿也会自动被裁。再点一次即释放，蒙版路径保留为无填充状态。上面那张霓虹海报里"太阳被山脉遮住"的效果，就是把山形放在太阳上层、对所在图层切换了一次蒙版做出来的。
第三关：批量整理与交付
散落的行归拢：从拖拽到收集
- 拖行重排：把行拖到目标行上方/下方/内部（拖放线或高亮框会预告落点），即可重排叠放顺序或把对象移入图层/组；Alt+拖行变为复制。行拖到底部垃圾桶删除，拖到新建图层按钮上则是复制一层。
- 拖"选择列"小方块：选中一批对象后，把它所在行的选择列方块拖到另一个图层上，整批图稿就搬过去了（Alt+拖是复制）。
- 批量归拢还是 Collect in New Layer 最省事：高亮行或选中对象直接进新格。
四个瘦身命令：合并、打平、释放、反转
图层堆到几十层之后，crates/engine/src/cmd/layerpanel.rs 提供的这四个命令是标准瘦身手段：
- Merge Selected（合并所选）——高亮两行以上，全部并入最后一个高亮的图层，内容保持原有叠放顺序，被搬空的图层自动消失；
- Flatten Artwork（打平图稿）——把所有可见顶层图层的内容并入一个图层，隐藏图层连同内容被删除，模板图层则保留；这是交印刷前的标准动作（想保留隐藏的备用稿？先把它们打平合并，或用模板图层收纳）；
- Release to Layers（释放到图层）——把图层/组里的每个对象拆成独立子图层：Sequence 版按叠放顺序逐格拆开；Build 版让每个新子图层都包含到自身为止的副本，各层逐格叠加，适合做可分层交付的资源；
- Reverse Order（反转顺序）——同一图层或组内两行以上的叠放顺序整体反转，"底图盖住了标题"这类事故反手即解。
交付前顺手勾上的开关
- Paste Remembers Layers（粘贴保留图层）：开启后，粘贴的对象按图层名回到原图层（同名图层不存在时自动在顶部新建），跨文件搬零件不会把目标文件搅成一锅；
- 打平前确认隐藏图层里没藏需要交付的内容，模板图层会原样保留、不打进结果；
- 交付文件前用 ≡ 菜单里的 Flatten Artwork 走一遍，用
document.inspect（面板同款树视图）抽查一遍层级。
练手清单：今晚就能做完的十五分钟
打开仓库里的 examples/neon-drive.vectorcraft（或直接 git clone https://gitcode.com/gh_mirrors/ve/vectorcraft 后打开 examples/ 目录），按顺序做一遍：
- 用 Alt+点眼睛 隔离"太阳"所在图层，检查形状后再点一次恢复；
- 选中两个散落对象，Collect in New Layer 归拢，给它起个名字、换个图层颜色；
- 新建一个图层放一张参考截图，标记为模板，确认它锁定、淡化且不会进导出；
- 把某个图层的顶部对象用 Make/Release Clipping Mask 变成蒙版，再释放回原状；
- 高亮三个图层执行 Merge Selected，再用 Reverse Order 把叠放顺序倒回来；
- 打开 Panel Options…，切一行小尺寸（Row Size），再勾"仅显示图层"，体会两种面板密度。
做完这六步，眼睛列手势、子图层、模板图层和打平动作都已经进过手了。更多命令细节可查 docs/mcp.md 的 "The Layers panel" 章节和 docs/control-protocol.md，源码想追根究底就顺着 crates/ui-egui/src/panels/layers.rs（面板交互）与 crates/engine/src/cmd/layer.rs（命令实现）两条线往下读。图层面板整理得不只是文件，更是你自己下次打开它时的心情。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
