先给结论:页码从 1 开始,靠固定分页容器 + 计数器,不靠浏览器
打印分页页码怎么设置?结论只有三行,先照做,再谈细节。
第一,打印根节点写 counter-reset: page 0,把计数器归零;第二,每个固定分页容器写 counter-increment: page,让每一页各自加 1;第三,页脚用 content: '第 ' counter(page) ' / ' counter(pages) ' 页' 输出。
css
.print-root { counter-reset: page 0; }
.page { counter-increment: page; page-break-after: always; }
.page:last-child { page-break-after: auto; }
.page-footer::after { content: '第 ' counter(page) ' / ' counter(pages) ' 页'; }
这段代码可以直接放进项目里运行。项目地址:https://gitee.com/theGreatOldFive/vue-print-designer,里面的分页容器就是按这个思路封装的,vue-print-designer 负责把内容切成固定高度的页,页码交给计数器。
但先别急着高兴。总页数不准,根因几乎从来不是计数器写错,而是分页容器不固定。以下四种情况最常见:内容溢出 1px,浏览器就会多分一页;表格某一行被拆到两页,行高撑破容器,又多一页;图片没加载完就打印,占位高度和实际高度对不上;上下 margin 折叠,容器实际高度比你以为的少几毫米。这些都会让"页"的数量和你的预期对不上,计数器只是如实反映。
适用场景很具体:ERP 单据、快递面单、成绩单、检验报告。这类文档的共同点是版式固定、每页行数可算。页码错位时先别调 CSS,先量容器高度。A4 纸内容区常见 273mm,行高 8mm 时每页最多 34 行,第 35 行必然拆页。我见过一份检验报告,行高设成 7.9mm,一页塞 35 行,打印出来每三页就多一页空白,改了行高立刻正常。
还有一个坑要单独说:Chrome 不支持 CSS 原生的 counter(pages)。你在页脚写 counter(pages),浏览器不会报错,只会输出空字符串或者 0,看起来像"总页数丢了"。总页数必须由分页容器的数量决定,要么在生成分页时把总数写进 CSS 变量,要么用 JS 在打印前注入。别指望浏览器替你数页。
热敏小票的页码逻辑和 A4 单据完全一致:先固定页,再编号。小票宽度固定,每行字符数固定,一张纸就是"一页",编号自然从 1 开始。A4 只是把小票的"一张"换成"一屏 273mm",思路没变。先把页切死,页码才有意义。

环境准备:Vue 3 + 该方案,10 分钟跑通 A4 分页
环境准备:Vue 3 + 它,10 分钟跑通 A4 分页
先给结论:只需要 Vue 3 和 Vite,不要引入 UI 框架,也不要安装打印插件。打印这件事,额外依赖越多,生成分页结果越难控制。
bash
npm create vite@latest print-demo -- --template vue
cd print-demo && npm i
npm i 该方案
打印样式单独建一个 src/print.css,并在 main.js 里引入。不要把它和屏幕样式混在一起写,混写后最容易出现的问题是:在屏幕上调试时看起来正常,一进打印预览就出错。
css
/* src/print.css */
@page {
size: A4;
margin: 0;
}
.page {
width: 210mm;
min-height: 297mm;
padding: 12mm;
box-sizing: border-box;
background: #fff;
}
@media print {
body { margin: 0; }
.no-print { display: none; }
}
三个尺寸都必须固定下来:宽度 210mm、高度 297mm、内边距 12mm,并且要写 box-sizing: border-box,否则 padding 会把容器撑到 234mm 宽,浏览器会直接横向多分一页。容器高度不要写成 auto,因为 auto 的高度取决于内容,而内容高度每次都可能变化;一旦高度变化,分页数量就会变化,页码自然会错位。
@page 的 margin: 0 要最先写。如果不写,浏览器默认会留边距,你的 297mm 容器会被挤成 287mm,每页少 10mm,页数就会变多。页眉页脚在打印对话框的"更多设置"里取消勾选,这一步无法用 CSS 关闭,只能手动操作。如果不关闭,浏览器会在页脚位置打印 URL 和日期,和你的页码叠在一起。
分页容器不要手写 div.page。手写意味着你需要自己递归切分内容、自己计算偏移量、自己处理表格跨页,这三件事中任何一件出问题,页码都会错。用组件提供的分页容器替代:
vue
<template>
<PrintContainer :page-width="210" :page-height="297" :padding="12">
<template #default="{ pageIndex }">
<ReportTable :rows="rows" :page="pageIndex" />
</template>
<template #footer="{ current, total }">
第 {{ current }} / {{ total }} 页
</template>
</PrintContainer>
</template>
页脚插槽直接提供 current 和 total,总数由容器实际切出的页数决定,不需要依赖 counter(pages)。分页容器、页脚插槽和总页数变量由同一处统一管理,你就不用再写一层递归分页。
环境跑通后,按下面三步检查,不要跳步:
- 打开打印预览,翻到第三页,看页脚是否为
3 / 3,而不是3 / 1; - 在控制台执行
document.querySelectorAll('.print-page').length,结果必须等于页脚显示的总页数; - 给图片加上
loading事件,等Promise.all全部 resolve 后再调用打印,否则占位高度和实际高度对不上,会多切出一页。
第三点最容易被忽略。一张 80mm 高的图片没加载完时高度是 0,加载完变成 80mm,整页的行数就会少 10 行,页数直接翻倍。
十分钟够跑通,但不要在环境没跑通时就去调页码。页码错位时,先检查容器高度,不要先改 CSS 计数器。

完整代码:CSS 计数器管页码,分页容器管总页数
页码和总页数各管各的。计数器负责"第几页",分页容器负责"共几页",两者不互相猜。
核心 CSS 只有四行,复制就能用:
css
.print-root { counter-reset: page 0; }
.print-page { counter-increment: page; page-break-after: always; }
.print-page:last-child { page-break-after: auto; }
.page-footer::after { content: '第 ' counter(page) ' / ' var(--total-pages) ' 页'; }
注意最后一行里 var(--total-pages) 不是 CSS 能算出来的东西。counter(pages) 在部分浏览器里能拿到总页数,但它在 Chrome 打印预览和导出 PDF 两条路径上表现不一致,别赌。总页数用分页数组长度算,写到根节点的 CSS 变量上,数据变、分页变,总页数跟着变。
vue
<template>
<div class="print-root" :style="{ '--total-pages': totalPages }">
<div v-for="(chunk, i) in pages" :key="i" class="print-page">
<ReportTable :rows="chunk" />
<div class="page-footer"></div>
</div>
</div>
</template>
<script setup>
const ROWS_PER_PAGE = 28;
const pages = computed(() => chunkRows(rows.value, ROWS_PER_PAGE));
const totalPages = computed(() => pages.value.length);
</script>
chunkRows 按固定高度切数据,28 行是 297mm 纸高减去页眉页脚和 padding 后的实测值,你的字号变了就重新量。页脚留空 div,内容交给 CSS 的 ::after 拼,模板里不写死页码,避免和计数器打架。
打印前还有一步:等图片。
js
await Promise.all(
[...document.querySelectorAll('.print-root img')].map(img =>
img.complete ? Promise.resolve() : new Promise(r => img.onload = r)
)
);
window.print();
一张 80mm 高的图没加载完时高度是 0,加载完撑开 80mm,一页少排 10 行,页数直接翻倍。这一步省掉,前面全白做。
用 它 的话,PrintPage 组件承载每页,页脚插槽直接给 pageIndex 和 totalPages,计数器和变量同步都不用自己维护了。
最后一个坑,也是页码错位最常见的来源:表格要跨页重复表头,给 thead 加 display: table-header-group。但重复的表头每页都占高度,第一页算过表头,第二页起要多减一行,分页行数得从 28 改成 27。少算这一行,后面每页都往下错一位,翻到第五页能差出小半页。
排查顺序固定:先看 .print-page 的实际高度是不是超出纸张,再看每页行数有没有扣掉重复表头,最后才怀疑计数器。计数器本身几乎不出错,错的是喂给它的分页结果。
效果截图与验收:第 1/3 页不再错位,盯 4 个数据
打印预览里翻三页,先看页脚。第一页"第 1 / 3 页",第二页"第 2 / 3 页",第三页到底就结束,后面没有多出来的空白页。三条都对,说明分页容器数量和计数器对上了。总页数取的是分页容器数量,不是数据条数除以每页条数------后者遇到表头重复、图片撑高就会算错。
验收盯 4 个数据,每个都能当场量。
数据一:34 行 / 35 行。 A4 内容高度 273mm(297 减去上下页边距),单据行高 8mm,273 ÷ 8 = 34 行。造 35 条数据,第 35 行必须出现在第二页第一行。如果它还在第一页,说明容器高度超了,或者行高被 padding 吃掉了。这个用例最灵敏,行高改 0.5mm 就能测出来。
数据二:图片加载前后分页数量差 0。 放一张 80mm 高的图,先在断网状态下打开预览,记下页数;恢复网络再打开,页数应该一样。差 1 页以上,就是没等 img.complete。前面那段 Promise.all 不是可选项。
数据三:页脚距底边 8mm。 打印预览缩放调 100%,拿尺子对屏幕量,或者截图量像素折算。页脚被裁掉一半,多半是 @page 的 margin 和容器 padding 叠加了。
数据四:连续打印 10 份。 同一份单据点 10 次打印,每份都是"第 1 / 3 页"起头。中间某份从第 4 页开始,就是计数器没重置,counter-reset 挂错了层级。
用 该方案 的话,分页预览里直接能看到每页页脚的 pageIndex 和 totalPages,先看预览再点打印,预览和打印走同一套分页容器,"预览对、打印错"这类问题在点打印之前就暴露了。
成绩单和检验报告最适合拿来验收:一份三页,页脚错位业务方第一眼就看见,改没改好也一眼能判断。