PrintDocument 是 Windows Forms 的底层打印通道，用于简单打印（如小票），而非生成复杂报表；它仅提供 Graphics 绘图能力，缺乏自动分页、多格式导出及样式管理等报表核心功能。
PrintDocument 不是报表生成器，它只是 Windows Forms 下的底层打印通道。真正在 C# 中“生成报表”，核心动作是：把结构化数据按业务规则渲染成可读、可导出、可复用的视觉文档——这一步必须依赖专用报表引擎或手动构造输出格式。
为什么不用 PrintDocument 直接做报表？
很多人卡在第一步：以为绑个 PrintPage 事件、用 e.Graphics.DrawString 拼几行字就是“生成报表”。实际会立刻撞上三堵墙：
- 没有自动分页逻辑 —— 表格跨页时表头不重复、页脚不居中、内容被截断
- 无法导出 PDF/Excel ——
PrintDocument只走打印机驱动，不产生文件流 - 样式与数据强耦合 —— 字体、边框、合并单元格全靠手算坐标，改一个字段位置就要重调所有
DrawString坐标
换句话说：PrintDocument 是“画图”，不是“生成报表”。它适合极简单据（如小票），但不适用于带分组、交叉汇总、动态列、条件高亮的业务报表。
FastReport 和 CrystalReports 的数据绑定本质是什么？
它们不是魔法，底层都是 ADO.NET + 报表模板解析引擎。关键差异在于数据消费方式：
-
FastReport默认接受DataTable、IEnumerable<T>或IDataReader，内部将数据转为命名数据集（如"Orders"），模板里用{Orders.OrderID}引用 -
CrystalReports强依赖DataSet结构，要求模板设计时就绑定到特定DataTable名称和字段名；运行时若字段缺失或类型不匹配，直接抛CrystalReportsException - 两者都支持参数化查询，但
FastReport的Report.GetDataSource("Orders")可运行时替换数据源，CrystalReports的SetDataSource()必须在加载前调用，否则报InvalidOperation
所以别迷信“拖控件就完事”——模板里写的每个 {xxx} 都对应一次反射取值或索引器访问，字段名拼错一个字母，预览时就空白。
NPOI 手动生成 Excel 报表时，样式共享陷阱怎么破？
NPOI 的 ICellStyle 是工作簿级共享对象。常见错误是：
- 循环写入多行时，反复调用
cell.CellStyle = workbook.CreateCellStyle()—— 看似新建，实则创建了大量冗余样式，Excel 打开时提示“文件已损坏” - 想给某列加红色字体，却修改了全局
DefaultCellStyle，导致所有未显式设样式的单元格也变红
正确做法是缓存样式对象：
// ✅ 推荐：按样式特征哈希缓存
private static readonly Dictionary<string, ICellStyle> _styleCache = new();
public static ICellStyle GetOrCreateStyle(IWorkbook wb, string key) {
if (!_styleCache.TryGetValue(key, out var style)) {
style = wb.CreateCellStyle();
// 根据 key 解析并设置字体、对齐等...
_styleCache[key] = style;
}
return style;
}
注意：key 必须包含所有影响样式的维度（字体名+大小+颜色+对齐+边框），漏一个就可能复用错样式。
报表导出 PDF 时中文乱码的根本原因
不是字体没嵌入，而是 PDF 渲染引擎默认用 Base14 字体（如 Helvetica），不支持中文。不同工具处理方式不同：
-
FastReport：需在设计器里选中文本控件 → 属性面板设Font.Name = "SimSun"→ 勾选Embed Font（否则部署到无中文字体的服务器就乱码） -
CrystalReports：必须提前在开发机安装对应字体，并在报表属性中启用Use Unicode Fonts，否则导出 PDF 时自动降级为??? - 纯代码方案（如 iTextSharp）：必须显式注册中文字体路径，且 PDF 内容要用
BaseFont.CreateFont("simhei.ttf", BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED)—— 注意NOT_EMBEDDED在无字体环境必乱码
最容易被忽略的一点：Windows 服务或 IIS 应用池账户默认无用户字体缓存权限，即使装了字体，File.ReadAllBytes("simhei.ttf") 也可能因路径或权限失败而静默回退到默认字体。
