%20(1).png)
ComfyUI-NodeAligner 插件保姆级教程
1. 插件简介
插件地址： https://github.com/Tenney95/ComfyUI-NodeAligner
这个插件就像给你的 ComfyUI 装了一个"整理小助手"！你知道当你在桌子上摆放很多物品时，总是想让它们排列得整整齐齐吗？这个插件就是专门干这个事情的！
它能帮你做这些超实用的事情：
- 让节点排队站好 - 就像让小朋友排队一样，可以让所有节点左对齐、右对齐、上对齐、下对齐
- 让节点居中站立 - 就像拍合照时让大家都站在中间位置
- 让节点大小一致 - 就像统一服装尺码，让所有节点变成一样的宽度或高度
- 让节点均匀分布 - 就像在房间里均匀摆放家具，让节点之间的距离都相等
想象一下，你在做复杂的工作流时，节点乱七八糟地散落在画布上，看起来就像乱糟糟的房间。有了这个插件，一键就能让所有节点变得井井有条，就像有个专业的整理师帮你收拾房间一样！
插件包含节点总数： 1 个（前端功能节点）
- 这是一个纯前端插件，没有传统意义上的"处理节点"，而是提供了一个浮动工具栏
2. 如何安装
方法一：手动下载安装
- 打开你的 ComfyUI 文件夹，找到
custom_nodes这个文件夹 - 在命令行中输入：
cd /你的ComfyUI路径/custom_nodes git clone https://github.com/Tenney95/ComfyUI-NodeAligner.git
方法二：直接复制文件夹
- 从 GitHub 下载插件的压缩包
- 解压后把整个
ComfyUI-NodeAligner文件夹复制到ComfyUI/custom_nodes目录下 - 重启 ComfyUI 就可以使用了
注意： 这个插件不需要安装额外的依赖包，下载后直接就能用！
3. 节点详细解析
3.1 NodeAligner 工具栏 - 你的节点整理神器
这个插件安装后会在你的 ComfyUI 界面上显示一个浮动的工具栏，就像一个随身携带的工具箱。这个工具栏包含了 14 个不同的功能按钮，每个按钮都有自己的"超能力"！
3.2 NodeAligner 工具栏参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 左对齐按钮 | alignLeft | 点击触发 | 无 | 就像让所有人靠左边站队，把选中的节点都移到最左边那个节点的位置 | 将选中节点的左边缘对齐到最左侧节点的左边缘 | 选中3个节点，点击后它们的左边都会对齐成一条直线 |
| 垂直居中按钮 | alignCenterVertically | 点击触发 | 无 | 就像让所有人站在房间的正中央（左右方向），让节点在水平方向上居中对齐 | 将选中节点在X轴方向上居中对齐 | 选中几个高低不同的节点，点击后它们会在水平方向上对齐到中心线 |
| 右对齐按钮 | alignRight | 点击触发 | 无 | 就像让所有人靠右边站队，把选中的节点都移到最右边那个节点的位置 | 将选中节点的右边缘对齐到最右侧节点的右边缘 | 选中几个节点，点击后它们的右边都会对齐成一条直线 |
| 顶部对齐按钮 | alignTop | 点击触发 | 无 | 就像让所有人的头顶都在同一个高度，把节点都移到最上面那个节点的位置 | 将选中节点的顶部边缘对齐到最上方节点的顶部边缘 | 选中几个上下位置不同的节点，点击后它们的顶部会对齐成一条水平线 |
| 水平居中按钮 | alignCenterHorizontally | 点击触发 | 无 | 就像让所有人站在房间的正中央（上下方向），让节点在垂直方向上居中对齐 | 将选中节点在Y轴方向上居中对齐 | 选中几个左右位置不同的节点，点击后它们会在垂直方向上对齐到中心线 |
| 底部对齐按钮 | alignBottom | 点击触发 | 无 | 就像让所有人的脚底都在同一个高度，把节点都移到最下面那个节点的位置 | 将选中节点的底部边缘对齐到最下方节点的底部边缘 | 选中几个节点，点击后它们的底部会对齐成一条水平线 |
| 水平分布按钮 | horizontalDistribution | 点击触发 | 无 | 就像在一条线上均匀摆放物品，让节点在水平方向上等距离排列 | 在水平方向上均匀分布选中的节点，使它们之间的间距相等 | 选中5个节点，点击后它们会在水平方向上等距离排成一排 |
| 垂直分布按钮 | verticalDistribution | 点击触发 | 无 | 就像在一条竖线上均匀摆放物品，让节点在垂直方向上等距离排列 | 在垂直方向上均匀分布选中的节点，使它们之间的间距相等 | 选中几个节点，点击后它们会在垂直方向上等距离排成一列 |
| 等宽按钮（最大值） | equalWidth | 点击触发 | 无 | 就像把所有盒子都做成一样宽，让所有节点的宽度变成最宽那个节点的宽度 | 将所有选中节点的宽度调整为最宽节点的宽度 | 选中大小不同的节点，点击后它们都会变成一样宽（以最宽的为准） |
| 等宽按钮（最小值） | equalMinWidth | 点击触发 | 无 | 就像把所有盒子都做成一样宽，但是以最窄的那个为标准 | 将所有选中节点的宽度调整为最窄节点的宽度 | 选中大小不同的节点，点击后它们都会变成一样宽（以最窄的为准） |
| 等高按钮（最大值） | equalHeight | 点击触发 | 无 | 就像把所有盒子都做成一样高，让所有节点的高度变成最高那个节点的高度 | 将所有选中节点的高度调整为最高节点的高度 | 选中高低不同的节点，点击后它们都会变成一样高（以最高的为准） |
| 等高按钮（最小值） | equalMinHeight | 点击触发 | 无 | 就像把所有盒子都做成一样高，但是以最矮的那个为标准 | 将所有选中节点的高度调整为最矮节点的高度 | 选中高低不同的节点，点击后它们都会变成一样高（以最矮的为准） |
| 拖拽分割线 | divider | 鼠标拖拽 | 无 | 就像抓住工具箱的把手，可以把整个工具栏拖到你想要的位置 | 允许用户拖拽移动整个工具栏的位置 | 按住分割线（黑色竖条）拖拽，可以把工具栏移动到屏幕任意位置 |
| 显示模式切换 | isPermanent | True/False | True | 就像选择工具箱是一直放在桌上，还是需要时才拿出来 | 控制工具栏是否始终显示或仅在选中节点时显示 | 右键工具栏选择"驻留"就一直显示，选择"选中后显示"就只在选中2个以上节点时显示 |
| 位置记忆功能 | localStorage | 坐标值 | 自动保存 | 就像记住你把工具箱放在哪里，下次打开还在原来的位置 | 自动保存工具栏位置到浏览器本地存储 | 拖拽工具栏到新位置后，下次打开ComfyUI工具栏还在那个位置 |
4. 使用技巧和建议
4.1 基础操作技巧
- 选择节点：按住 Shift 或 Ctrl 键可以选择多个节点，就像在电脑上选择多个文件一样
- 取消选择：点击空白区域就能取消所有选择，就像点击桌面取消文件选择
- 重置视图：如果没选中任何节点时点击左对齐，画布会回到原点位置，就像按了"回到起点"按钮
4.2 对齐功能使用技巧
- 分组对齐：当你选择很多节点时，插件会智能地把相近的节点分成组，然后分别对齐，就像把乱放的书按书架分别整理
- 单节点操作：选择单个节点时，左对齐和顶部对齐会把节点移到画布的左上角（0,0位置）
4.3 分布功能使用技巧
- 水平分布：适合整理横向排列的节点，比如处理图片的一系列步骤
- 垂直分布：适合整理纵向排列的节点，比如从输入到输出的处理流程
- 智能分组：分布功能会自动识别哪些节点应该在同一行或同一列
4.4 尺寸调整技巧
- 等宽功能：有两种模式，一种是让所有节点变成最宽的那个尺寸，另一种是变成最窄的尺寸
- 等高功能：同样有两种模式，可以选择以最高或最矮的节点为标准
- 5的倍数对齐：尺寸会自动调整为5的倍数，让界面看起来更整齐
4.5 工具栏使用技巧
- 拖拽移动：抓住工具栏中间的黑色分割线可以拖拽移动整个工具栏
- 模式切换：右键点击工具栏可以选择是否一直显示，还是只在需要时显示
- 位置记忆：工具栏会记住你放置的位置，下次打开还在原地
5. 常见问题解答
5.1 为什么工具栏不显示？
答： 就像有些工具需要特定条件才出现：
- 检查插件是否正确安装在
custom_nodes文件夹中 - 重启 ComfyUI 试试
- 如果设置了"选中后显示"模式，需要选择2个以上节点才会显示
5.2 为什么点击按钮没有反应？
答： 就像使用工具需要先选择材料：
- 确保你已经选择了需要操作的节点
- 大部分功能需要选择至少2个节点才能生效
- 检查节点是否真的被选中了（选中的节点会有高亮边框）
5.3 工具栏位置不对或跑到屏幕外面了怎么办？
答： 就像工具箱掉到了看不见的地方：
- 刷新页面，工具栏会自动检测并回到默认位置
- 或者清除浏览器的本地存储数据重新开始
5.4 为什么对齐效果不是我想要的？
答： 就像整理房间有不同的方法：
- 插件会智能分组，相近的节点会被当作一组来处理
- 如果你想要所有节点都按同一个标准对齐，确保它们的位置不要相差太远
- 可以先手动调整节点的大致位置，再使用对齐功能
5.5 等宽等高功能为什么有两个按钮？
答： 就像统一尺寸有两种思路：
- 第一个按钮（实心图标）：让所有节点变成最大的那个尺寸
- 第二个按钮（空心图标）：让所有节点变成最小的那个尺寸
- 根据你的需要选择合适的方式
5.6 如何批量移动多个节点？
答： 就像同时搬运多个物品：
- 选中多个节点后，按住 Shift 键拖拽其中一个节点
- 所有选中的节点都会一起移动
- 这个功能配合对齐工具使用效果更好
6. 高级使用技巧
6.1 工作流程优化
- 先粗后细：先用拖拽把节点大致摆放到合适区域，再用对齐工具精确调整
- 分层整理：把相关功能的节点先分组整理，再整体布局
- 保持间距：使用分布功能让节点间距保持一致，提高可读性
6.2 快捷操作组合
- 快速对齐：选中节点 → 左对齐 → 顶部对齐 → 等宽 → 垂直分布
- 整齐排列：选中一行节点 → 顶部对齐 → 水平分布 → 等高
- 网格布局：先按行对齐，再按列对齐，最后调整间距
6.3 界面美化建议
- 使用对齐功能让工作流看起来更专业
- 保持节点大小的一致性，提高视觉效果
- 合理使用分布功能，避免节点过于拥挤或分散
7. 总结
ComfyUI-NodeAligner 插件就像给你的 ComfyUI 配备了一个专业的"整理师"。无论你是新手还是老手，这个插件都能帮你：
- 提高效率：一键完成复杂的节点排列工作
- 美化界面：让你的工作流看起来更加专业整洁
- 减少错误：整齐的布局让你更容易发现和修改问题
- 节省时间：不用再手动一个个调整节点位置
记住最重要的几点：
- 选择节点是使用所有功能的前提
- 工具栏可以拖拽移动，位置会自动保存
- 右键工具栏可以切换显示模式
- 多尝试不同的对齐和分布组合，找到最适合你的布局方式
现在你已经掌握了这个强大的布局工具，快去让你的 ComfyUI 工作流变得井井有条吧！