ComfyUI-Text 插件完整新手教程

1. 插件简介

ComfyUI-Text 是一个专门处理文字的简单插件，插件地址：https://github.com/MarkoCa1/ComfyUI-Text

这个插件就像一个万能的文字工具箱，能帮你在制作图片时处理各种文字相关的任务。比如： - 把多段文字合并成一段（就像把几个便签贴在一起） - 显示文字内容（就像一个透明的显示屏） - 替换文字中的某些内容（就像用修正液改错字） - 添加随机元素让文字更丰富

作者说他只需要简单的文字操作功能，不想安装太多复杂的东西，所以做了这个轻量级的插件。

2. 如何安装

方法一：通过 ComfyUI Manager 安装（推荐）

1. 打开 ComfyUI，点击右下角的 "Manager" 按钮
2. 在搜索框里输入 "ComfyUI-Text"
3. 找到这个插件后点击 "Install"
4. 重启 ComfyUI 就能使用了

方法二：手动安装

1. 打开你的 ComfyUI 安装文件夹
2. 进入 custom_nodes 文件夹
3. 在这里打开终端或命令行
4. 输入：git clone https://github.com/MarkoCa1/ComfyUI-Text.git
5. 重启 ComfyUI

3. 节点详细解析

3.1 Text Display 节点 - 文字显示器

这个节点就像一个透明的显示屏，可以把文字显示在画面上，方便你查看当前的文字内容。

参数详解：

| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :— | :— | :— | :— | :— | :— | :— | | text | text | 字符串 | 任意文本 | 这就是你要显示的文字内容，像在纸上写字一样 | 接收文本输入并在节点界面显示 | 输入"今天天气很好"，节点就会显示这句话 | | font_size | font_size | 数字 | 12-24 | 调节文字大小，就像调节放大镜的倍数 | 控制显示文本的字体大小 | 设置18表示中等大小的字体 | | text_color | text_color | 颜色代码 | #FFFFFF | 设置文字颜色，就像选择不同颜色的笔 | 定义文本显示的颜色值 | #FF0000表示红色文字 |

3.2 Text Concatenate 节点 - 文字拼接器

这个节点就像胶水，能把多段文字粘在一起变成一段完整的文字。

参数详解：

| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :— | :— | :— | :— | :— | :— | :— | | text1 | text1 | 字符串 | 任意文本 | 第一段要合并的文字，像第一张便签 | 第一个文本输入源 | 输入"我喜欢" | | text2 | text2 | 字符串 | 任意文本 | 第二段要合并的文字，像第二张便签 | 第二个文本输入源 | 输入"画画" | | separator | separator | 字符串 | 空格或逗号 | 两段文字之间的分隔符，像两个词之间的空格 | 连接两个文本的分隔字符 | 输入空格，结果就是"我喜欢 画画" | | text3 | text3 | 字符串 | 任意文本 | 第三段要合并的文字，像第三张便签 | 第三个文本输入源 | 输入"和音乐"，最终结果"我喜欢 画画 和音乐" |

3.3 Text Replace 节点 - 文字替换器

这个节点就像修正液，能把文字中的某些内容替换成其他内容。

参数详解：

| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :— | :— | :— | :— | :— | :— | :— | | text | text | 字符串 | 任意文本 | 原始文字内容，就像一篇要修改的文章 | 需要进行替换操作的源文本 | 输入"我喜欢红色的花" | | old_text | old_text | 字符串 | 要替换的文字 | 要被替换掉的文字，就像错别字 | 要被替换的目标字符串 | 输入"红色"，表示要把"红色"替换掉 | | new_text | new_text | 字符串 | 新的文字 | 用来替换的新文字，就像正确的字 | 用于替换的新字符串 | 输入"蓝色"，结果就是"我喜欢蓝色的花" | | case_sensitive | case_sensitive | 布尔值 | false | 是否区分大小写，就像是否区分大写字母A和小写字母a | 控制替换时是否区分字符大小写 | false表示A和a被认为是同一个字母 |

3.4 Text Length 节点 - 文字计数器

这个节点就像一个计数器，能告诉你文字有多少个字符。

参数详解：

| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :— | :— | :— | :— | :— | :— | :— | | text | text | 字符串 | 任意文本 | 要计算长度的文字，就像要数字符个数的句子 | 需要计算长度的文本输入 | 输入"Hello World"，会输出11（包括空格） | | count_type | count_type | 选择项 | characters | 计算方式：字符数还是单词数，就像数字母还是数词语 | 选择计算字符数量还是单词数量 | characters数字符，words数单词 |

3.5 Text Split 节点 - 文字分割器

这个节点就像一把剪刀，能把一长段文字按照某个标记分割成多段。

参数详解：

| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :— | :— | :— | :— | :— | :— | :— | | text | text | 字符串 | 任意文本 | 要分割的原始文字，就像一根要切断的绳子 | 需要分割的源文本 | 输入"苹果,香蕉,橙子" | | separator | separator | 字符串 | 逗号或空格 | 分割标记，就像切绳子的位置标记 | 用于分割文本的分隔符 | 输入逗号","，就会分成三段 | | max_split | max_split | 数字 | -1 | 最多分割几次，-1表示全部分割 | 限制分割操作的最大次数 | 设置1只分割一次，变成"苹果"和"香蕉,橙子" |

3.6 Text Case 节点 - 文字大小写转换器

这个节点就像一个大小写转换器，能把文字变成全大写、全小写或首字母大写。

参数详解：

| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :— | :— | :— | :— | :— | :— | :— | | text | text | 字符串 | 任意文本 | 要转换大小写的文字，就像要变形的字母 | 需要进行大小写转换的源文本 | 输入"Hello World" | | case_type | case_type | 选择项 | lower | 转换方式：upper全大写，lower全小写，title首字母大写 | 选择大小写转换的类型 | lower变成"hello world" |

3.7 Text Trim 节点 - 文字修剪器

这个节点就像一个修剪器，能去掉文字前后的空格和多余的空白。

参数详解：

| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :— | :— | :— | :— | :— | :— | :— | | text | text | 字符串 | 任意文本 | 要修剪的文字，就像要整理的草坪 | 需要去除空白字符的文本 | 输入" Hello World " | | trim_type | trim_type | 选择项 | both | 修剪方式：both两端，left左边，right右边 | 选择去除空白字符的位置 | both会变成"Hello World" |

4. 使用技巧和建议

4.1 文字处理的基本流程

1. 先显示再处理：建议先用Text Display节点查看文字内容，确认无误后再进行其他处理
2. 分步骤处理：复杂的文字处理可以分成几个步骤，每个节点处理一种操作
3. 保存中间结果：处理过程中可以用多个Display节点查看中间结果

4.2 常用组合技巧

• 文字清理组合：Text Trim + Text Replace，先去空格再替换内容
• 文字格式化组合：Text Case + Text Concatenate，先统一大小写再合并
• 文字验证组合：Text Length + Text Display，检查文字长度并显示

4.3 参数设置建议

• 分隔符使用空格或逗号比较安全
• 颜色代码建议使用常见的如#FFFFFF（白色）、#000000（黑色）
• 字体大小建议在12-24之间，太小看不清，太大占地方

5. 常见问题解答

Q1：为什么我输入的中文显示不正常？

A1：确保你的ComfyUI支持中文字符，如果还是有问题，可以尝试重启ComfyUI。

Q2：Text Concatenate节点只能合并两段文字吗？

A2：不是的，你可以连接多个Text Concatenate节点，就像搭积木一样，实现更多段文字的合并。

Q3：替换功能为什么没有生效？

A3：检查一下old_text参数是否完全匹配，包括大小写和空格。如果不确定，可以将case_sensitive设为false。

Q4：如何处理很长的文字？

A4：可以先用Text Split节点分割成小段，分别处理后再用Text Concatenate合并。

Q5：节点连接后没有输出怎么办？

A5：检查输入参数是否正确，确保前一个节点有输出，可以用Text Display节点查看中间结果。

6. 实际应用案例

案例1：制作动态提示词

使用Text Concatenate节点合并基础提示词和随机元素，创建变化丰富的提示词。

案例2：批量文字处理

使用Text Replace节点批量替换文字中的特定内容，比如把所有"红色"替换为"蓝色"。

案例3：文字格式标准化

使用Text Case和Text Trim节点统一文字格式，去除多余空格并统一大小写。

这个插件虽然功能简单，但在处理文字时非常实用。记住一个原则：简单的工具组合起来就能完成复杂的任务。多多练习，你会发现这些基础的文字处理节点能帮你解决很多实际问题！