iMac的Texmaker中tabularray环境计数代码编译异常问题

问题原因 #

• tabularray的表格环境默认会对表头行、内容行、分隔线甚至部分隐藏元素触发计数器递增，要是代码里包含了表头定义、全局分隔线命令（比如\hline{1-Z}），或者不小心在非目标行调用了计数器递增逻辑，就会导致计数器在你看不到的地方被累加，最终显示的行号出现跳变。
• 另一种可能是自定义的行号计数器没有在表格开始前重置，之前的文档内容已经触发过该计数器，导致初始值不是1。

解决办法 #

方法1：用tabularray内置行号功能（推荐） #

tabularray自带成熟的行号机制，无需手动维护计数器，直接在表格选项里配置即可：

\documentclass{article}
\usepackage{tabularray}
\begin{document}
\begin{tblr}{
  colspec={Q[r]X}, % 第一列放行号，第二列存内容
  row{1}={font=\bfseries}, % 设置表头样式
  row{2-Z}={rownum=\arabic{rownum}}, % 从第2行开始显示行号
  rownum=1, % 指定行号初始值为1
}
表头1 & 表头2 \\
内容1 & 内容1详情 \\
内容2 & 内容2详情 \\
内容3 & 内容3详情 \\
\end{tblr}
\end{document}

方法2：手动控制计数器的递增时机 #

如果一定要手动维护计数器，要确保只在内容行触发递增，并且表格开始前重置计数器：

\documentclass{article}
\usepackage{tabularray}
\newcounter{mytabrow} % 定义独立计数器，避免冲突
\begin{document}
\setcounter{mytabrow}{0} % 表格前重置计数器到0
\begin{tblr}{colspec={Q[r]X}}
表头1 & 表头2 \\
\stepcounter{mytabrow} \themytabrow & 内容1详情 \\
\stepcounter{mytabrow} \themytabrow & 内容2详情 \\
\stepcounter{mytabrow} \themytabrow & 内容3详情 \\
\end{tblr}
\end{document}

• 注意：别在表头行、分隔线代码里调用\stepcounter，只在实际内容行前执行递增操作。

方法3：排查计数器冲突 #

如果文档里其他地方用了同名计数器，或者tabularray的全局配置（比如自动添加分隔线）导致计数器被意外触发，换一个独特的计数器名称（比如上面的mytabrow），就能避免冲突。

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