ExcelJS页面水平/垂直居中（horizontalCentered/verticalCentered）设置失效求助

算力阿峰

2026-5-14

解决ExcelJS生成文件后页面居中设置不生效的问题

我之前也碰到过类似的ExcelJS页面居中设置不生效的坑，给你几个实用的排查和解决方向：

确认操作的是模板中的目标工作表
很多时候问题出在代码里新建了工作表，而不是操作模板里已有的那一张。比如你要确保是通过getWorksheet获取模板里的工作表，而不是用addWorksheet创建新表：

const workbook = new Excel.Workbook();
// 加载模板文件
await workbook.xlsx.readFile('你的模板文件.xlsx');
// 获取模板里的目标工作表（替换成你的表名，比如Sheet1）
const worksheet = workbook.getWorksheet('Sheet1');
// 设置页面居中
worksheet.pageSetup.horizontalCentered = true;
worksheet.pageSetup.verticalCentered = true;
// 保存新文件
await workbook.xlsx.writeFile('生成的新文件.xlsx');

升级ExcelJS到最新稳定版
旧版本的ExcelJS在pageSetup属性的处理上存在一些兼容性bug，建议升级到v4.x及以上的稳定版本。执行下面的命令更新：
```
npm update exceljs
```

强制刷新页面设置状态
有时候模板里的原有设置可能和代码设置产生冲突，可以尝试先重置再重新设置，强制触发属性更新：

// 先重置为false
worksheet.pageSetup.horizontalCentered = false;
worksheet.pageSetup.verticalCentered = false;
// 再设置为true
worksheet.pageSetup.horizontalCentered = true;
worksheet.pageSetup.verticalCentered = true;

检查文件保存选项
确保调用writeFile时没有使用会忽略页面设置的自定义选项，默认的保存配置是保留格式的，但如果你自定义了选项，要确认没有禁用pageSetup相关的属性：
```
await workbook.xlsx.writeFile('生成的新文件.xlsx', {
  // 避免添加会覆盖或忽略页面设置的配置
  properties: {
    // 这里保持默认或按需配置，不要禁用页面设置
  }
});
```