本文介绍在 python 中通过 pycups 库为自定义页面尺寸（如非标准票据或标签纸）精确配置左右/上下边距的方法，涵盖 ppd 属性设置、`cupspagesize` 与 `pageregion` 的协同使用，并提供可直接运行的代码示例。
在使用 PyCUPS 进行自定义尺寸打印时，仅设置 PageSize（如 “720×432″）只能控制纸张物理尺寸，无法直接控制内容在纸面上的打印区域（即边距）。真正实现“设定边距”的核心在于理解 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 的支持性，并在生产环境中加入异常处理与日志反馈。