使用iTextSharp将HTML转PDF时部分CSS样式不生效问题咨询

这个问题在使用iTextSharp的XMLWorker转换HTML到PDF时太常见了——毕竟XMLWorker对CSS的支持并不完整，尤其是布局类属性，和前端浏览器的支持度差得不少。咱们一步步拆解解决：

1. 关于float:left不生效的问题 #

XMLWorker对CSS float 属性的支持非常有限，基本只能处理极简单的行内元素场景，稍微复杂点的布局直接失效。我的建议是用表格布局替代浮动效果，因为XMLWorker对HTML表格的渲染支持稳定得多。比如你原本想让两个元素左浮动并排，改成用<table>包裹，把元素放在<td>里，就能实现类似的并排效果。

如果一定要用代码层面调整，也可以考虑放弃纯HTML/CSS，改用iTextSharp的原生API手动构建布局（比如用Paragraph+Chunk，或者ColumnText），但这样工作量会大很多。

2. 关于margin-right:500px不生效的问题 #

这里有两个大概率的原因：

• 单位问题：PDF的核心单位是pt（点），XMLWorker对px（像素）的解析并不友好。建议把单位换成pt，换算比例大概是1px ≈ 0.75pt，所以500px差不多等于375pt，试试改成margin-right: 375pt;。
• 元素类型问题：行内元素（比如<span>）的margin属性通常不会被XMLWorker识别，要确保你的目标元素是块级元素（比如<div>），或者给元素加上display:block;的样式。

额外建议：考虑升级到iText 7 #

如果你的项目允许的话，强烈建议升级到iText 7（以及对应的HtmlConverter组件）。iText 7对CSS的支持比旧版iTextSharp好太多，大部分现代CSS布局属性（包括float、margin的各个方向）都能正常解析，转换效果更接近浏览器渲染的结果。

针对你现有代码的小调整示例 #

假设你的CSS原本是：

.float-element {
  float: left;
}
.margin-element {
  margin-right: 500px;
  color: red;
}

可以改成这样试试：

/* 用inline-block替代浮动，至少能让元素在同一行，比float靠谱 */
.float-element {
  display: inline-block;
}
.margin-element {
  display: block;
  margin-right: 375pt; /* 换成pt单位 */
  color: red;
}

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