使用reStructuredText与Sphinx生成PDF时csv-table居中对齐失效问题

在Sphinx 5.1.1中，csv-table的:align: center默认仅控制表格整体在页面中的位置，而非单元格内容的对齐。要实现单元格内容居中，可按以下方法处理：

方法一：使用column-alignment参数直接指定 #

在csv-table定义中添加:column-alignment:参数，为每一列设置对齐方式（支持left/center/right），参数值数量需与表格列数匹配：

.. csv-table:: 示例表格
   :align: center          # 表格整体居中
   :header-rows: 1
   :column-alignment: center center center  # 三列全部居中

   姓名,年龄,职业
   张三,28,工程师
   李四,32,设计师

方法二：通过LaTeX配置全局或自定义样式 #

若使用Sphinx默认的LaTeX后端生成PDF，可修改conf.py添加自定义LaTeX样式，再关联到csv-table：

1. 在项目的conf.py中添加LaTeX预定义：

latex_elements = {
    'preamble': r'''
        \usepackage{array}
        % 定义居中列类型，m{3cm}表示固定宽度3cm，可根据需求调整
        \newcolumntype{C}{>{\centering\arraybackslash}m{3cm}}
    ''',
}

2. 在csv-table中指定:latex-columns:参数，使用自定义的居中列类型：

.. csv-table:: 示例表格
   :align: center
   :header-rows: 1
   :latex-columns: C C C

   姓名,年龄,职业
   张三,28,工程师
   李四,32,设计师

注意：如果你的PDF生成后端不是LaTeX（比如使用rst2pdf），需要对应调整后端的配置参数，但Sphinx默认PDF构建依赖LaTeX，优先推荐上述两种方法。

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