jspdf 本身不支持直接对 rect() 等基础绘图命令应用旋转，但可通过其内置的 canvas-like context2d 接口，结合 save()/restore() 和 rotate() 实现精准旋转变换。
jspdf 本身不支持直接对 rect() 等基础绘图命令应用旋转，但可通过其内置的 canvas-like context2d 接口，结合 save()/restore() 和 rotate() 实现精准旋转变换。
在 jsPDF 中，doc.rect() 是一个封装好的高阶绘图方法，它不接受旋转参数，也无法单独为某次绘制设置变换矩阵。若需旋转矩形（或其他图形），必须切换至底层的 2D 上下文（doc.context2d），利用类似 HTML5 Canvas 的 API 进行手动绘制与坐标系变换。
✅ 正确做法：使用 context2d + 坐标变换
const { jsPDF } = window.jspdf; // 或 import { jsPDF } from "jspdf";
const doc = new jsPDF();
// 获取底层 2D 绘图上下文（仅在支持 context2d 的版本中可用，如 >= 2.5.1）
const ctx = doc.context2d;
// 保存当前绘图状态（重要！避免影响后续绘制）
ctx.save();
// 平移到旋转中心点（例如矩形左上角为 (100, 0)，宽70高70，我们以其中心为旋转原点）
const x = 100, y = 0, width = 70, height = 70;
const centerX = x + width / 2;
const centerY = y + height / 2;
ctx.translate(centerX, centerY);
// 应用旋转变换（单位：弧度；例如 45° = π/4）
ctx.rotate(Math.PI / 4);
// 以 (0, 0) 为中心绘制矩形（注意：此时坐标系已平移+旋转）
ctx.fillStyle = 'rgba(255, 255, 200, 1)';
ctx.fillRect(-width / 2, -height / 2, width, height);
// 恢复原始坐标系
ctx.restore();
// 导出 PDF
doc.save('rotated-rectangle.pdf');
⚠️ 关键注意事项：
- context2d 仅在 jsPDF ≥ 2.5.1 版本中默认启用（旧版需手动启用或不可用）；
- 必须配合 ctx.save() 和 ctx.restore() 使用，否则旋转会持续影响后续所有绘制；
- rotate() 作用于整个坐标系，不是图形本身——因此需先 translate() 将原点移至期望旋转中心，再旋转，最后绘制；
- fillRect() / strokeRect() 不支持圆角等高级样式，如需 rect(..., 'F') 的填充效果，请用 fillRect()；如需描边+填充组合，可调用 strokeRect() + fillRect() 或使用路径（beginPath() → rect() → fill() → stroke()）；
- 若需旋转文本、图像或复杂路径，同样适用该模式，只需在变换后调用对应绘图方法即可。
? 替代方案（兼容性更强）
若项目受限于旧版 jsPDF（无 context2d），可改用 doc.lines() 或 doc.path() 手动构建旋转后的四边形顶点坐标（通过旋转矩阵计算），再绘制闭合路径并填充。但开发成本显著增加，推荐优先升级 jsPDF 并使用 context2d 方案。
总之，旋转矩形的本质是坐标系变换，而非图形属性修改——掌握 save/translate/rotate/restore 四步法，即可灵活实现任意角度、任意锚点的图形旋转。
