ComfyUI-text-overlay 插件完全新手教程

1. 插件简介

插件地址： https://github.com/mikkel/ComfyUI-text-overlay

这个插件就像给你的照片贴标签一样简单！想象一下，你有一张美美的照片，想要在上面加上文字，比如加个标题、写个名字、或者加点说明文字。这个插件就是专门干这个事的。

它能帮你做什么？ - 在图片上添加任何你想要的文字 - 调整文字大小，想要大标题还是小注释都行 - 选择文字颜色，红的绿的蓝的随你挑 - 把文字放在图片的任何位置 - 选择不同的字体，让文字更好看 - 调整文字的排列方式（左对齐、居中、右对齐）

2. 如何安装

安装这个插件就像下载一个手机APP一样简单：

打开你的 ComfyUI 文件夹
找到 custom_nodes 这个文件夹（就是放插件的地方）
在这个文件夹里打开命令行（或者终端）
输入这行命令： git clone https://github.com/mikkel/ComfyUI-text-overlay
等待下载完成
重启 ComfyUI

3. 节点详解

3.1 Image Text Overlay 节点 - 图片文字叠加器

这是插件的核心节点，就像一个文字印章机器。你把图片放进去，告诉它要印什么文字、印在哪里、用什么颜色，它就帮你把文字印到图片上。

3.2 参数详解

参数名 (UI显示)	参数名 (代码里)	参数值	建议值	通俗解释 (能干嘛的)	专业解释	怎么用/举个例子
图片	image	图片数据	任意图片	这就是你要加文字的那张图片	输入的图像张量数据	从前面的节点拖一根线过来，比如从"加载图片"节点
文字内容	text	文本字符串	"Hello World"	你想要在图片上显示的文字内容	要渲染的文本字符串	比如输入"我的作品"、"2024年夏天"等
字体路径	font_path	文件路径	系统默认字体	告诉机器用哪种字体来写字	字体文件的完整路径	比如"C:/Windows/Fonts/arial.ttf"
字体大小	font_size	数字	20-50	控制文字的大小，就像调节打印机的字号	字体渲染的像素大小	数字越大文字越大，比如输入30就是中等大小
文字颜色	color	十六进制颜色码	0xFFFFFF	设置文字的颜色，就像选择彩色笔的颜色	RGB色彩值的十六进制表示	0xFFFFFF是白色，0x000000是黑色，0xFF0000是红色
X坐标	x	数字	50-100	控制文字在图片上的水平位置，就像调节标签贴在哪里	文字左边缘的水平像素位置	0是最左边，数字越大越靠右
Y坐标	y	数字	50-100	控制文字在图片上的垂直位置，就像调节标签贴多高	文字上边缘的垂直像素位置	0是最上面，数字越大越靠下
对齐方式	alignment	文本选项	"left"	控制文字相对于坐标点的排列方式	文本的水平对齐方式	"left"左对齐，"center"居中，"right"右对齐

4. 使用技巧和建议

4.1 文字颜色选择小窍门

白色文字(0xFFFFFF)： 适合放在深色背景上，比如夜景照片
黑色文字(0x000000)： 适合放在浅色背景上，比如白色背景
红色文字(0xFF0000)： 用来强调重要信息
蓝色文字(0x0000FF)： 看起来比较专业，适合标题

4.2 文字位置摆放建议

左上角： 适合放标题或者日期
右下角： 适合放署名或者版权信息
居中： 适合放主要的说明文字
避免放在图片主体上： 不要遮挡重要内容

4.3 字体大小选择

小文字(10-20)： 适合放版权信息、拍摄参数
中等文字(20-40)： 适合放普通说明文字
大文字(40-80)： 适合放标题、重要提示

4.4 字体选择建议

如果不知道用什么字体，直接用系统默认的就很好
想要更好看的字体，可以去下载字体文件
Windows系统的字体在：C:/Windows/Fonts/ 文件夹里
Mac系统的字体在：/System/Library/Fonts/ 文件夹里

5. 常见问题解答

Q: 为什么我的文字显示不出来？ A: 可能是颜色设置问题。如果你的图片是白色背景，而你设置的是白色文字，当然看不见。试试换成黑色(0x000000)。

Q: 文字位置不对怎么办？ A: 检查一下X和Y坐标。记住，X控制左右，Y控制上下。如果文字跑到图片外面了，说明坐标数值太大了。

Q: 怎么让文字居中显示？ A: 把对齐方式设置成"center"，然后X坐标设置成图片宽度的一半左右。

Q: 可以添加多行文字吗？ A: 这个插件一次只能添加一行文字。如果想要多行，需要连接多个这样的节点。

Q: 字体文件路径怎么找？ A: 在Windows系统里，按Win+R，输入fonts就能看到所有字体。右键点击想要的字体，选择"属性"就能看到路径。

Q: 为什么字体显示不正常？ A: 可能是字体文件路径写错了，或者选择的字体不支持中文。建议用系统自带的字体。

6. 实用工作流程示例

6.1 给照片加水印

加载你的图片
连接到 Image Text Overlay 节点
文字内容填写你的名字或者网站
设置小字体(15-25)
选择白色或黑色
放在右下角位置
设置右对齐

6.2 制作标题图片

加载背景图片
连接到 Image Text Overlay 节点
文字内容填写标题
设置大字体(40-60)
选择醒目的颜色
放在图片中央
设置居中对齐

6.3 批量加日期标注

加载多张图片
连接到 Image Text Overlay 节点
文字内容填写日期
设置中等字体(20-30)
选择合适的颜色
统一放在左上角
设置左对齐

7. 进阶技巧

7.1 颜色代码速查表

白色：0xFFFFFF
黑色：0x000000
红色：0xFF0000
绿色：0x00FF00
蓝色：0x0000FF
黄色：0xFFFF00
紫色：0xFF00FF
青色：0x00FFFF

7.2 多层文字叠加

如果你想要在一张图片上加多个文字（比如标题+日期+署名），可以： 1. 第一个 Image Text Overlay 节点加标题 2. 第二个 Image Text Overlay 节点连接第一个的输出，加日期 3. 第三个 Image Text Overlay 节点连接第二个的输出，加署名

7.3 与其他节点配合使用

这个插件可以和其他图片处理节点一起使用： - 先用滤镜美化图片，再加文字 - 先加文字，再调整图片亮度对比度 - 配合图片缩放节点，制作不同尺寸的带文字图片

记住，这个插件就像一个贴标签的机器，简单但非常实用。多试几次，你就能熟练掌握了！

ComfyUI文字叠加插件新手入门指南