使用cv2.putText()可在图像上添加文本，参数包括图像、文本内容、位置、字体、大小、颜色、粗细和线型，支持多种字体类型，但仅限ASCII字符，中文需借助PIL实现。
在Python中使用OpenCV为图像添加文本，主要通过 cv2.putText() 函数实现。这个函数可以将指定的字符串绘制到图像上，常用于图像标注、结果显示等场景。
基本语法
cv2.putText(img, text, org, font, fontScale, color, thickness, lineType)
参数说明：
- img：要绘制文本的图像（必须是NumPy数组，通常为BGR格式）
- text：要写入的字符串，如 "Hello OpenCV"
- org：文本左下角的坐标 (x, y)
- font：字体类型，如 cv2.FONT_HERSHEY_SIMPLEX、cv2.FONT_HERSHEY_DUPLEX 等
- fontScale：字体缩放比例，1.0 为默认大小，可增大或缩小
- color：文本颜色，BGR格式，例如 (255, 0, 0) 表示蓝色
- thickness：文本线条的粗细
- lineType：可选，线型，推荐使用 cv2.LINE_AA 实现抗锯齿效果
简单示例代码
import cv2
<h1>读取图像</h1><p>image = cv2.imread('example.jpg')</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill8775" title="Java Maven Common"><img
src="https://img.php.cn/upload/skill/000/000/081/179222954019613.jpg" alt="Java Maven Common" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill8775" title="Java Maven Common">Java Maven Common</a>
<p>Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。</p>
</div>
<a href="/xiazai/skill8775" title="Java Maven Common" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/00968c3c2c15" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">Python免费学习笔记（深入）</a>”；</p><h1>添加文本</h1><p>cv2.putText(image,
text='Hello OpenCV',
org=(50, 100),
fontFace=cv2.FONT_HERSHEY_SIMPLEX,
fontScale=1.2,
color=(0, 255, 0), # 绿色
thickness=2,
lineType=cv2.LINE_AA)</p><h1>显示结果</h1><p>cv2.imshow('Image with Text', image)
cv2.waitKey(0)
cv2.destroyAllWindows()</p>常用字体类型
OpenCV 提供了多种内置字体，可根据需要选择：
- cv2.FONT_HERSHEY_SIMPLEX —— 基础无衬线字体
- cv2.FONT_HERSHEY_PLAIN —— 小号简洁字体
- cv2.FONT_HERSHEY_DUPLEX —— 更清晰的无衬线字体（比SIMPLEX细节更好）
- cv2.FONT_HERSHEY_COMPLEX —— 带衬线字体
- cv2.FONT_HERSHEY_TRIPLEX —— 更粗的衬线字体
- cv2.FONT_HERSHEY_SCRIPT_SIMPLEX 和 SCRIPT_COMPLEX —— 手写风格字体
注意事项
- 图像必须是 NumPy 数组格式，如果是用 PIL 读取的需先转换
- 中文字符不支持直接显示，cv2.putText() 只支持 ASCII 字符。若需显示中文，建议使用 PIL 来绘制文本，再转回 OpenCV 格式
- 坐标 (org) 超出图像范围会导致文本被截断或不可见
- 颜色顺序为 BGR，不是 RGB
基本上就这些。掌握 putText 函数后，可以在图像中标注关键信息，比如人脸检测中的标签、识别结果等，非常实用。
