Allegro创建Group操作指导：从edit-groups到Create Group的PCB设计实践

1. Allegro 里 Group 到底解决什么问题：从 edit-groups 到 Create Group 的 PCB 分组管理

如果你正在用 Allegro 做 PCB 布局，手上有一堆去耦电容、一组 DDR 数据线、或者一整块电源模块的器件需要整体挪动、整体锁定、整体复用，那你迟早会碰到 Group 这个功能。简单说，Allegro 的 Group 就是把器件（symbols）、过孔（vias）、走线（clines）、铜皮（shapes）这些对象打包成一个逻辑单元，之后你可以按组选中、按组移动、按组做规则约束。它适合谁？适合所有需要把「一堆零散对象当成一个整体来管理」的硬件工程师，尤其是做模块化布局、多路相同电路复用、以及需要反复调整局部布局的场景。

我见过太多人第一次用的时候，直接在画布上框选一堆器件然后右键，发现根本没有「创建组」这个选项，于是以为 Allegro 不支持。其实入口藏在菜单栏的edit-groups里，而且创建过程中会弹一个确认框，很多人手快点了否，结果白忙一场。这篇就按真实操作顺序，把菜单路径、Options 配置、Find 过滤、验证动作一步步拆开，让你一次做对。

核心检索词先明确：Allegro 创建 Group、edit-groups 菜单、Create Group 弹窗、Find 面板过滤 symbols/vias/clines/shapes、Groups 单位移动。这几个词贯穿全文，你照着做就能复现。

先说清楚 Group 和 Net Class、Match Group 的区别，避免概念混淆。Net Class 管的是电气规则，比如线宽、间距、差分对；Match Group 管的是等长约束；而 Group 是物理对象的集合，它不改变电气属性，只改变你在编辑时的选择粒度。换句话说，Group 是「操作层面」的打包，不是「规则层面」的归类。理解这一点，你就知道为什么创建 Group 时 Find 面板要选 symbols、vias、clines、shapes 这些物理对象，而不是选 nets。

实际项目里 Group 的典型用法有这么几类。第一类是模块复用：比如你有一路电源电路，包含电感、电容、IC、反馈电阻，布局调好后打成 Group，复制到其他通道时整体操作，位置关系不会乱。第二类是整体避让：结构工程师说某个区域要挖空，你把那块的所有器件和走线打成 Group，整体平移，不用一个个重新选。第三类是锁定保护：布局定稿的区域打成 Group 后配合 fix 属性，防止后续误操作。第四类是协同评审：把关键模块打成 Group，导出或截图时高亮显示，方便和同事沟通。

这里要提醒一个高频误区：Group 创建后，成员对象并没有被「焊死」，你依然可以单独选中组内某个器件进行编辑。Group 只是提供了一个批量选择的快捷方式，不是容器隔离。所以如果你想要的是「禁止单独修改」，那应该用 fix 属性或者规则约束，而不是指望 Group。这个区别在排查问题时很关键，后面第五节会展开。

另外，Allegro 的 Group 是存在设计数据库里的，跟着 .brd 文件走。你换一台机器打开同一个 brd，Group 还在。但如果你用 sub-drawing 或者 place replicate 去复用，Group 信息不一定完整带过去，这点在做模块复用时要注意验证。实测下来，最稳妥的复用方式还是把 Group 和 place replicate 结合，或者干脆用 Group 做临时操作单元，复用靠器件矩阵。

最后说下版本差异。Allegro 17.2 和 17.4 在 edit-groups 的入口位置基本一致，都在菜单栏。但 17.4 的 Options 面板布局有调整，Group 名字输入框的位置可能略有不同。如果你用的是 16.6 或更早版本，菜单叫法可能不一样，但逻辑相通。本文以 17.4 为主，其他版本对照着找同名菜单即可。下面进入具体操作。

2. 动手前的准备：TaoToken 接入与 Allegro 环境确认

在讲具体菜单操作之前，先花点时间把环境理顺。很多报错其实不是 Allegro 本身的问题，而是工具链配置没对齐。如果你在团队里做协同设计，或者需要把设计数据、脚本、AI 辅助工具串起来，那接入一个稳定的 API 网关会让后续的自动化省很多事。TaoToken 在这里的角色是提供一个统一的模型调用入口，方便你写脚本做批量检查、自动生成约束文档、或者把设计意图转成可执行的规则描述。

先说 TaoToken 的接入。官网地址是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 端点是 https://taotoken.net/api 。注意 API 地址后面不加 UTM 参数，保持干净。你需要先去控制台创建一个 API Key，控制台入口在 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，API Keys 管理页在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 。拿到 Key 之后，你可以用它调用模型对话能力，入口在 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite ，文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。

为什么在 Allegro 教程里提这个？因为实际工作中，Group 的创建往往不是一次性的，你可能需要批量处理几十个模块，或者根据网表自动生成分组建议。这时候用脚本调用模型做辅助判断，比手工一个个框选快得多。当然，如果你只是做单板手工布局，这部分可以先跳过，直接看第三节的菜单操作。

Allegro 环境确认清单如下。第一，确认你的 license 包含 Allegro PCB Designer 或以上版本，Group 功能在基础版里就有，不需要额外选项。第二，确认工作目录有写权限，Group 信息会写入 brd 数据库，如果文件只读会创建失败。第三，确认 Find 面板可用，有些精简模式会隐藏 Find，需要在 View 菜单里打开。第四，确认没有处于某种特殊编辑模式，比如正在走线或者正在放置器件，这时候 edit-groups 可能是灰的，先按 Esc 退出当前命令。

如果你用 Claude Code 或者类似的编码助手来写 Allegro 脚本，可以配置一下 Base URL 指向 TaoToken 的 API，这样脚本里的模型调用就走统一入口。配置片段在下一节给出，这里先记住三件套：Base URL、API Key、Model ID。Base URL 用 https://taotoken.net/api ，Key 用你控制台生成的，Model ID 按文档里支持的填。Coding Plan 适合长期做脚本开发的场景，入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。

环境确认还有一个容易忽略的点：单位。Allegro 默认单位可能是 mil 或 mm，Group 本身不依赖单位，但你框选时的精度受单位影响。建议在 Setup 里确认设计单位，避免框选时漏掉边缘对象。另外，如果你开了格点吸附，框选范围可能被格点限制，必要时临时关掉格点。

最后提醒一句，Group 的命名要有规范。别用 Group1、Group2 这种默认名，后期根本分不清。建议用「功能_位置_版本」的格式，比如 PWR_DCDC_U1、DDR_CH0_TOP。命名规范在团队协作里价值很大，后面验证和排查都靠它定位。

3. 可复制配置：edit-groups 菜单路径与 Create Group 完整参数

这一节是核心操作，我把每一步的菜单路径、Options 配置、Find 过滤都写清楚，你可以直接照着点。先给一个可复制的配置片段，如果你用脚本或配置文件管理 Allegro 环境，可以参考这个结构。

{ "allegro_group_config": { "menu_path": "Edit > Groups", "options_group_name": "PWR_DCDC_U1", "create_group_dialog": "Yes", "find_filters": ["symbols", "vias", "clines", "shapes"], "selection_mode": "window_select", "finish_action": "right_click_done", "verify_command": "edit-groups", "move_command": "move", "move_find_filter": "groups" } }

这个 JSON 不是 Allegro 直接读取的，而是给你做脚本或文档时的参考结构。实际操作用的是 GUI，下面逐步说。

第一步，打开 edit-groups。在 Allegro 菜单栏找到 Edit，下拉里找 Groups。注意不是 Edit > Move，也不是 Edit > Change，就是 Groups。点进去之后，Options 面板会变成 Group 相关设置。如果你找不到 Edit 菜单，检查一下是不是在某个全屏命令里，按 Esc 退出。

第二步，在 Options 里输入 Group 名字。Options 面板通常在设计窗口右侧或下方，里面有一个 Group Name 输入框。输入你规范好的名字，比如 PWR_DCDC_U1。这里有个坑：名字不能有空格，不能用特殊字符，建议只用字母、数字、下划线。输完名字先别急着点别的，下一步会弹窗。

第三步，处理 Create Group 弹窗。输入名字后，Allegro 会弹一个确认框，问你是否创建新 Group。这里必须选「是」或「Yes」。很多人手快点了「否」，然后发现 Find 面板选不了，以为软件坏了。其实是你拒绝了创建，后面所有操作都无效。点「是」之后，Group 就进入待填充状态。

第四步，配置 Find 面板。Find 面板通常在右侧，里面有一堆复选框。你要勾选的是 symbols、vias、clines、shapes。这四个对应器件、过孔、走线、铜皮。如果你只想把器件打成组，那只勾 symbols 也行，但通常建议四个都勾，这样框选时不会漏掉走线和铜皮。注意不要勾 nets，nets 是电气网络，不是物理对象，勾了也选不中。

第五步，框选对象。在画布上按住鼠标左键拖一个矩形框，把你要归组的对象框进去。框选时注意，Allegro 默认是「包含」模式，即对象只要有一部分在框内就会被选中。如果你只想选完全在框内的，需要在 Options 里改选择模式。框选后，被选中的对象会高亮。

第六步，右键 Done。框选完，在画布上右键，菜单里选 Done。这时候 Group 就创建完成了。你可以看到刚才选中的对象作为一个整体被记录。如果右键菜单里没有 Done，检查是不是还在框选状态，或者 Find 面板没配置好。

第七步，验证。重新点 Edit > Groups，在 Options 里看 Group 列表，应该能看到你刚创建的名字。或者用移动命令验证：点 Edit > Move，在 Find 面板里只勾 Groups，然后在画布上点一下你的 Group，整个组会被一起选中，移动时整体平移。这就说明分组生效了。

这里给一个 TOML 格式的配置参考，适合用配置文件管理多个 Group 定义的场景。

[group.PWR_DCDC_U1] menu = "Edit > Groups" name = "PWR_DCDC_U1" filters = ["symbols", "vias", "clines", "shapes"] verify = "edit-groups" move_filter = "groups" [group.DDR_CH0_TOP] menu = "Edit > Groups" name = "DDR_CH0_TOP" filters = ["symbols", "clines"] verify = "edit-groups" move_filter = "groups"

如果你用 Claude Code 做脚本开发，settings 片段可以这样写，把 Base URL、Key、Model ID 三件套配齐。

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "your_key_here", "ANTHROPIC_MODEL": "your_model_id" } }

注意 Base URL 是 https://taotoken.net/api ，不要加 UTM。Key 从控制台拿，Model ID 看文档。这样配置后，你在脚本里调用模型做设计辅助时，就走统一入口。Claude Code 的接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，里面有详细说明。

配置部分最后强调一点：Group 名字一旦创建，后续要修改得先解散再重建，没有直接重命名菜单。所以命名前想清楚。如果只是临时用，可以用 TMP_ 前缀，用完删掉。

4. 验证请求与成功结果：用 edit-groups 和 Move 确认分组生效

创建完 Group 不算完，必须验证它真的生效了。这一节给你两个验证动作，一个是静态检查，一个是动态检查。静态检查用 edit-groups 看列表，动态检查用 Move 命令看整体移动。

静态检查步骤。点 Edit > Groups，Options 面板里会显示当前设计里所有已创建的 Group。如果你刚创建了 PWR_DCDC_U1，这里应该能看到。如果看不到，说明创建过程有问题，回到第三节检查 Create Group 弹窗是不是点了否。另外，Options 里通常还有一个 Group 成员数量显示，你可以对照你框选的对象数量，确认没有漏选。

动态检查步骤。点 Edit > Move，然后在 Find 面板里只勾 Groups，其他全部取消。在画布上点击你的 Group 任意一个成员，整个组会被高亮选中。这时候移动鼠标，整个组跟着走。如果你只想移动组内单个器件，那就在 Find 里勾 symbols 而不是 Groups，这样点中的就是单个器件。这个对比能帮你确认 Group 的边界。

成功结果长什么样？第一，edit-groups 列表里有你的 Group 名字。第二，Move 时 Find 勾 Groups 能整体选中。第三，移动后组内对象的相对位置不变。第四，保存 brd 后重新打开，Group 还在。这四条都满足，说明分组完全生效。

这里给一个验证用的检查清单，你可以照着打勾。

如果你在验证时发现 Move 命令下 Find 里没有 Groups 选项，检查一下是不是 Find 面板被折叠了，或者当前命令不支持 Groups 过滤。Move 命令是支持 Groups 的，如果看不到，可能是版本差异，试试用 Edit > Groups 里的高亮功能替代。

还有一个进阶验证：用 Report 功能导出 Group 信息。在 Edit > Groups 状态下，有些版本支持右键 Report，能列出 Group 成员清单。这个在做设计评审时很有用，可以把清单贴到文档里。如果你的版本没有这个功能，可以用脚本遍历 Group 成员，输出到文本文件。

验证通过后，建议立刻保存一次 brd。Group 信息写入数据库需要保存动作，如果你创建完直接关掉不保存，下次打开就没了。这个坑很多人踩过，尤其是做了一半去开会，回来发现 Group 不见了。

最后说下验证时的常见现象。有时候你框选了一堆对象，创建 Group 后 Move 时发现只选中了一部分。这通常是因为 Find 过滤没配对，比如你创建时勾了 shapes，但 Move 时 Find 里没勾 shapes，导致铜皮没被选中。解决办法是创建和移动时保持 Find 过滤一致。另一个现象是 Group 创建后，单独点某个器件还是能选中，这是正常的，Group 不隔离单个对象的选择，前面解释过。

5. 本篇常见错排查：401、local proxy failed、reading choices、OAuth 对照

这一节把创建 Group 过程中可能遇到的报错和异常列出来，对照真实错误信息给排查方向。注意，有些报错来自工具链配置，不是 Allegro 本身，但会影响你的整体流程。

第一个，401 Unauthorized。这个通常出现在你调用 API 做脚本辅助时，不是 Allegro 界面报错。原因是你配置的 API Key 无效或过期。排查：去控制台 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 重新生成 Key，确认 Base URL 是 https://taotoken.net/api ，不要多加路径。如果你用 Claude Code，检查 settings 里的 ANTHROPIC_API_KEY 是不是填对了。

第二个，local proxy failed。这个报错说明你的网络配置有问题，可能是本地代理设置冲突。排查：检查环境变量里有没有 HTTP_PROXY、HTTPS_PROXY 之类的设置，如果有，临时清掉再试。注意，这里说的是本地网络配置排查，不是让你去用什么特殊工具，就是检查系统环境变量。Allegro 本身不需要代理，如果你在脚本里调 API，确保直连配置正确。

第三个，reading choices 相关报错。这个通常出现在模型返回结果解析时，比如你让模型输出 JSON 格式的 Group 配置，但返回内容不是合法 JSON，解析就报 reading choices 失败。排查：检查你的 prompt 是否明确要求 JSON 格式，模型返回后先打印原始内容看看。如果是 TaoToken 的模型对话接口，可以在 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite 先手动测试一下返回格式。

第四个，OAuth 相关报错。如果你用某些需要 OAuth 认证的工具，可能会遇到 token 过期或 scope 不足。排查：重新走一遍授权流程，确认 scope 包含你需要的权限。如果你只是用 API Key 方式，一般不会碰到 OAuth，除非你混用了两种认证方式。

除了这些工具链报错，Allegro 本身的 Group 操作也有几个高频问题。问题一：edit-groups 菜单是灰的。原因可能是当前有命令在执行，按 Esc 退出所有命令再试。问题二：Create Group 弹窗不出现。原因可能是 Options 里名字没输入，或者输入了非法字符。问题三：框选后右键没有 Done。原因可能是 Find 面板没勾任何对象，或者框选区域是空的。问题四：Group 创建后 Move 选不中。原因可能是 Find 里没勾 Groups，或者 Group 名字拼写不对。

再给一个对照表，方便你快速定位。

排查时记住一个原则：先确认基础操作对不对，再看工具链配置。很多问题其实是操作顺序错了，不是软件坏了。比如 Create Group 弹窗点否，后面全错。这种问题看报错信息是看不出来的，只能回到操作步骤核对。

如果你在团队里遇到别人创建的 Group 你这边看不到，检查 brd 文件是不是同一个版本，或者有没有被 lock。Allegro 的 Group 是存在设计文件里的，文件不同步就看不到。

6. 语义一致 CTA：把 Group 管理接入你的日常流程

Group 创建只是第一步，真正提升效率的是把分组管理和你的日常流程串起来。比如你可以写一个脚本，读取网表后自动建议哪些器件应该归组，然后用模型生成 Group 命名和配置。这时候 TaoToken 的 API 就派上用场了。模型对话入口在 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite ，你可以先手动测试几个 prompt，看看模型对 PCB 分组逻辑的理解。

如果你长期做编码和脚本开发，Coding Plan 更适合，入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。它提供稳定的调用额度，适合把模型能力嵌入到你的 Allegro 自动化脚本里。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，里面有完整的 API 说明和示例。

具体怎么串？举个例子。你有一个 brd 文件，里面 20 个电源模块需要分别打成 Group。手工做要重复 20 次框选，容易出错。你可以写一个 Skill 脚本，遍历器件列表，按预设规则分组，然后调用模型生成每个 Group 的命名建议和检查清单。脚本里的模型调用走 TaoToken 的 API，Base URL 用 https://taotoken.net/api ，Key 从控制台拿。这样一次配置，后续所有项目都能复用。

再比如，你做设计评审时，需要把每个 Group 的成员清单和布局截图整理成文档。可以用脚本自动导出 Group 信息，然后调模型生成评审要点。模型对话入口同上，先测试再集成。Claude Code 的接入方式在文档里有，配置好 Base URL、Key、Model ID 三件套就能用。

最后给一个实用技巧：Group 命名和你的网表命名保持一致。比如网表里电源模块叫 U1_DCDC，那 Group 就叫 PWR_U1_DCDC。这样脚本匹配时不用做映射，减少出错。命名规范定好后，写进团队文档，所有人遵守。

如果你在接入过程中遇到 API 报错，先对照第五节的排查表。401 查 Key，local proxy failed 查环境变量，reading choices 查返回格式。大部分问题都能自己解决。实在搞不定，去文档页找对应说明，或者用模型对话入口问一下，把报错信息贴进去，通常能得到排查方向。

流程串起来之后，你会发现 Group 不再是一个个手工操作，而是设计数据流里的一环。从网表到分组到验证到文档，全链路自动化。这才是 Allegro 分组管理的完整价值。