本文介绍在 python 中通过 pycups 库为自定义页面尺寸（如非标准票据或标签纸）精确配置左右/上下边距的方法，涵盖 ppd 属性设置、`cupspagesize` 与 `pageregion` 的协同使用，并提供可直接运行的代码示例。
在使用 PyCUPS 进行自定义尺寸打印时，仅设置 PageSize（如 "720x432"）只能控制纸张物理尺寸，无法直接控制内容在纸面上的打印区域（即边距）。真正实现“设定边距”的核心在于理解 CUPS 的页面布局模型：它通过两个关键 PPD 属性协同工作：
- PageSize：定义物理纸张大小（单位：点，1 inch = 72 pt）；
- PageRegion：定义可打印区域（即内容实际渲染的矩形），其坐标原点在纸张左下角，因此可通过偏移实现边距效果。
例如，若需在 10×6 英寸（720×432 点）纸上设置 左/下边距各 0.25 英寸（18 点），则 PageRegion 应设为从 (18, 18) 开始、宽高分别为 720−36=684、432−36=396 的区域（假设左右/上下边距对称）。
以下是完整、健壮的实现方案：
import cups
def print_with_margins(
printer_name: str,
file_path: str,
width_inch: float = 10.0,
height_inch: float = 6.0,
left_margin_inch: float = 0.25,
bottom_margin_inch: float = 0.25,
right_margin_inch: float = 0.25,
top_margin_inch: float = 0.25
):
conn = cups.Connection()
# 转换为点（1 inch = 72 points）
w, h = int(width_inch * 72), int(height_inch * 72)
l, b = int(left_margin_inch * 72), int(bottom_margin_inch * 72)
r, t = int(right_margin_inch * 72), int(top_margin_inch * 72)
# 计算 PageRegion：(x, y, width, height)，原点为纸张左下角
region_x = l
region_y = b
region_w = max(1, w - l - r) # 防止负值
region_h = max(1, h - b - t)
page_size_str = f"{w}x{h}"
page_region_str = f"{region_x}x{region_y}+{region_w}+{region_h}"
# 关键：同时指定 PageSize 和 PageRegion
print_options = {
'PageSize': page_size_str,
'PageRegion': page_region_str,
'Collate': 'True',
'fitplot': 'True' # 自动缩放内容以适应 PageRegion（可选）
}
try:
job_id = conn.printFile(printer_name, file_path, "Print Job", print_options)
print(f"✅ 打印任务 {job_id} 已提交至 '{printer_name}'")
print(f" 页面尺寸: {width_inch}×{height_inch} 英寸 ({w}×{h} 点)")
print(f" 可打印区域: 偏移({region_x},{region_y}) + 尺寸({region_w}×{region_h}) 点")
except cups.IPPError as e:
print(f"❌ IPP 错误: {e}")
raise
except Exception as e:
print(f"❌ 其他错误: {e}")
raise
# 示例调用：10×6 英寸纸，四周边距均为 0.25 英寸
if __name__ == "__main__":
print_with_margins(
printer_name="TVS_MSP-250CH-TVS-original",
file_path="/home/tk/Documents/bill.txt",
width_inch=10.0,
height_inch=6.0,
left_margin_inch=0.25,
bottom_margin_inch=0.25,
right_margin_inch=0.25,
top_margin_inch=0.25
)⚠️ 重要注意事项：
- 并非所有打印机驱动都支持 PageRegion；建议先执行 conn.getPrinterAttributes(printer_name) 检查返回字典中是否包含 'page-region-supported' 或相关 PPD 属性；
- 若驱动不支持，可改用 cups.Printer.setOption('page-left', '18') 等高级选项（需 CUPS ≥ 2.2.0 且驱动兼容）；
- fitplot=True 可确保内容自动缩放填满 PageRegion，但可能影响文本清晰度；如需精确排版，请在源文件中预设边距（如 PDF 使用 pdfcrop 或 HTML/CSS 设置 @page { margin: 18pt; }）；
- 使用 raw() 方法（如答案中所示）属于底层 PostScript 指令注入，不推荐用于通用场景——它绕过 CUPS 过滤器，易导致格式错乱，且与 printFile() 不兼容。
✅ 总结：PyCUPS 中设置边距的标准、可靠方式是组合使用 PageSize 和 PageRegion。它符合 CUPS 规范，兼容性好，且无需修改原始文档。务必验证目标打印机对 PageRegion 的支持性，并在生产环境中加入异常处理与日志反馈。
