如何用PyMuPDF使插入的PDF文本可见？附参数疑问

一、文本被图片遮挡的解决方法 #

你的问题核心是文本绘制层级错误：默认page.insert_text()的overlay参数为False，会把文本放在页面现有内容（比如你的图片）的底层，自然会被遮挡。手动设为False只是维持底层逻辑，PDF加载时底层文本会被后续渲染的顶层图片覆盖。

正确操作是将overlay设为True，让文本绘制在现有内容的顶层，就能避免被图片遮挡。修改后的代码如下：

doc = fitz.open("a.pdf")
for page in doc:
    page.insert_text(
        (page.rect.height - 50, 50), 
        "thistextthistext", 
        fontsize=18,
        color=(0,0,0),
        overlay=True  # 关键：将文本置于顶层
    )
doc.saveIncr()
doc.close()

另外注意坐标逻辑：page.insert_text()的坐标是(x, y)，其中y从页面顶部开始计算，你用page.rect.height - 50作为y值，相当于把文本放在页面底部区域，确认该位置是你需要显示的区域。

二、参数说明 #

1. render_mode（渲染模式） #

控制文本的绘制样式，对应PyMuPDF的fitz.TEXT_RENDER_MODE_*常量，常用效果：

• 0（默认）：仅填充文本（实心文字）
• 1：仅描边文字（空心轮廓）
• 2：填充+描边（实心文字加外轮廓）
• 其他取值还支持隐形文本、填充加下划线等特殊排版需求。

2. stroke_capacity（疑似笔误） #

PyMuPDF的page.insert_text()中没有stroke_capacity参数，推测是以下两个参数之一：

• stroke_width：控制文本描边的宽度，仅当render_mode设为描边或填充+描边时生效，数值越大轮廓越粗。
• stroke_cap：控制描边端点的样式，可选值为fitz.LINE_CAP_BUTT（平头，默认）、fitz.LINE_CAP_ROUND（圆头）、fitz.LINE_CAP_SQUARE（方头），影响文字边缘的端点形状。

内容的提问来源于stack exchange，提问作者wndev1