告别算法编号混乱：BIThesis中algorithm宏包按章编号的终极解决方案-优快云博客

告别算法编号混乱：BIThesis中algorithm宏包按章编号的终极解决方案

【免费下载链接】BIThesis 📖 北京理工大学非官方 LaTeX 模板集合，包含本科、研究生毕业设计模板及更多。🎉 （更多文档请访问 wiki 和 release 中的手册）项目地址: https://gitcode.com/GitHub_Trending/bi/BIThesis

在学术论文写作中，算法（Algorithm）作为核心研究成果的重要载体，其编号规范性直接影响论文的专业性与可读性。北京理工大学非官方LaTeX模板集合BIThesis（Beijing Institute of Technology Thesis）虽已集成algorithm2e与algorithmic等主流算法宏包，但用户在实现「按章节自动编号」功能时仍面临配置复杂、兼容性不足等问题。本文将系统剖析算法编号混乱的根源，提供两种宏包的分步配置方案，并通过可视化对比与实战案例，帮助研究者彻底解决这一学术排版痛点。

一、算法编号混乱的三大痛点

学术论文中的算法通常需要遵循「章-节-序号」的层级编号规则（如算法3-2表示第3章第2个算法），但在BIThesis模板中，默认配置往往导致三类典型问题：

1.1 全局连续编号陷阱

默认情况下，algorithm宏包采用全文连续编号机制，当论文包含多个章节时，会出现「算法1」「算法2」贯穿全文的情况，无法体现章节关联性。这种编号方式在学位论文盲审中常被评委指出「结构不清晰」。

1.2 跨宏包兼容性冲突

BIThesis支持algorithm2e与algorithmic两种主流宏包，但二者编号控制逻辑差异显著：

algorithm2e通过\SetAlgoRefName控制引用名称
algorithmic依赖\renewcommand{\thealgorithm}重定义计数器混用配置时易出现「编号断层」或「引用错误」，尤其在章节合并时问题突出。

1.3 模板样式覆盖问题

BIThesis的bithesis.cls文档类会对计数器进行统一管理，部分用户自定义的编号规则会被模板内置样式覆盖。典型表现为：在\chapter环境下设置的计数器重置命令失效，导致算法编号持续累加。

二、按章编号的技术原理与实现路径

2.1 LaTeX计数器机制

LaTeX通过计数器（Counter）系统实现编号管理，算法编号依赖algorithm计数器。按章编号需实现两个核心目标：

章节计数器变化时重置算法计数器
算法编号格式定义为「章节号-算法序号」

% 计数器依赖关系示意图
\@addtoreset{algorithm}{chapter} % 章节变化时重置算法计数器
\renewcommand{\thealgorithm}{\thechapter-\arabic{algorithm}} % 定义编号格式

2.2 BIThesis模板适配要点

BIThesis基于ctexbook文档类开发，其章节结构通过\chapter、\section等命令实现。需特别注意：

模板默认启用\CTEXsetup配置章节格式
盲审模式（blindPeerReview）可能影响计数器行为
算法环境需在\begin{document}之后进行配置

三、algorithm2e宏包实现方案（推荐）

BIThesis官方文档明确指出「此选项目前只支持algorithm2e宏包的algorithm环境」，因此推荐优先采用该方案。

3.1 基础配置三步骤

Step 1: 引入宏包与设置编号格式 在文档前置区（\documentclass之后）添加：

\usepackage[ruled,vlined]{algorithm2e} % 加载带边框的算法环境
\SetAlgoNumbering{chapter} % 启用按章编号
\SetAlgoRefName{算法} % 设置引用前缀为中文「算法」

Step 2: 配置计数器依赖 在\BITSetup之后添加计数器重置命令：

\makeatletter
\@addtoreset{algorithm}{chapter} % 关键：算法计数器随章节计数器重置
\makeatother

Step 3: 定义算法环境样式 通过\SetAlgorithmStyle调整字体与间距，确保与北理工论文格式要求一致：

\SetAlgorithmStyle{ruled} % 带线条边框
\SetAlCapFont{\heiti\zihao{5}} % 标题使用黑体五号字
\SetAlCapNameFnt{\heiti\zihao{5}} % 编号字体设置

3.2 完整代码示例

\documentclass[type=master]{bithesis}
\BITSetup{
  info = {
    author = {张三},
    title = {基于深度学习的目标检测算法研究},
    % 其他论文信息...
  }
}

% 算法宏包配置区
\usepackage[ruled,vlined]{algorithm2e}
\SetAlgoNumbering{chapter}
\SetAlgoRefName{算法}
\makeatletter
\@addtoreset{algorithm}{chapter}
\makeatother
\SetAlgorithmStyle{ruled}
\SetAlCapFont{\heiti\zihao{5}}
\SetAlCapNameFnt{\heiti\zihao{5}}

\begin{document}
\MakeCover % 生成封面

\chapter{绪论}
\section{研究背景}
% 正文内容...

\chapter{相关工作}
\section{传统目标检测算法}
\begin{algorithm}[H] % H表示当前位置插入
  \caption{传统SIFT特征提取算法} % 算法标题
  \KwIn{输入图像I}
  \KwOut{特征点集合F}
  1. 图像金字塔构建\;
  2. 高斯差分检测\;
  3. 关键点定位\;
  \Return F\;
\end{algorithm}
% 算法引用示例：\ref{alg:sift}
\label{alg:sift}

\end{document}

3.3 效果验证与常见问题

正确效果：第二章的第一个算法将显示为「算法2-1」，第三章首个算法重置为「算法3-1」。

排错指南：

若编号仍连续：检查是否遗漏\@addtoreset命令
若标题字体异常：确认\heiti是否可用（需CTEX宏集支持）
若位置浮动：[H]参数强制当前位置，替换默认的[tbp]浮动模式

四、algorithmic宏包兼容方案

对于习惯使用algorithmic+algorithm组合的用户，需通过计数器重定义实现兼容配置。

4.1 核心配置代码

\usepackage{algorithm} % 提供算法环境框架
\usepackage{algorithmic} % 提供算法步骤描述命令
\renewcommand{\thealgorithm}{\thechapter-\arabic{algorithm}} % 定义编号格式
\makeatletter
\@addtoreset{algorithm}{chapter} % 章节重置算法计数器
\makeatother
% 中文标题适配
\floatname{algorithm}{算法}

4.2 算法环境使用示例

\begin{algorithm}[H]
  \caption{基于CNN的目标检测算法}
  \label{alg:cnn}
  \begin{algorithmic}[1] % 带行号的算法步骤
    \STATE 输入图像预处理
    \STATE 特征图提取
    \FOR{$i=1$ to $N$}
      \STATE 候选区域生成
      \STATE 边界框回归
    \ENDFOR
    \RETURN 检测结果
  \end{algorithmic}
\end{algorithm}

五、两种宏包方案对比与选型建议

特性	algorithm2e	algorithmic+algorithm
BIThesis兼容性	官方推荐，兼容性最佳	需手动配置计数器，兼容性一般
中文支持	内置`\SetAlgoRefName`支持中文前缀	需`\floatname`单独设置
代码可读性	命令简洁（\KwIn, \KwOut）	命令冗长（\STATE, \FOR）
样式定制能力	丰富的样式参数（边框、字体等）	样式固定，定制困难
浮动控制	支持[H]强制位置	依赖algorithm宏包浮动机制

选型建议：

优先选择algorithm2e方案，尤其适合北理工学位论文
若需与现有algorithmic代码兼容，可采用方案二
提交前通过latexmk -C清除缓存，确保编号正确刷新

六、实战技巧与避坑指南

6.1 多算法交叉引用技巧

当需要在正文中引用算法时，推荐使用\cref命令（需加载cleveref宏包）：

\usepackage{cleveref} % 在导言区添加
% 正文引用：
如\cref{alg:sift}所示，传统算法存在计算复杂度高的问题。

效果：「如算法2-1所示...」（自动添加中文前缀）

6.2 章节合并时的编号修复

若通过\include或\input合并章节导致编号异常，可在每个章节末添加：

\setcounter{algorithm}{0} % 手动重置算法计数器

6.3 盲审模式下的特殊处理

启用盲审选项blindPeerReview=true时，需额外锁定计数器：

\ifblindPeerReview
  \@addtoreset{algorithm}{chapter} % 确保盲审模式下编号机制不变
\fi

七、总结与最佳实践清单

BIThesis中实现算法按章编号需遵循「宏包选择-计数器配置-样式适配」三步走策略，核心是通过\@addtoreset建立算法计数器与章节计数器的依赖关系。推荐使用algorithm2e宏包，并通过\SetAlgoNumbering{chapter}一键启用按章编号。

最终检查清单：

已加载正确的算法宏包（algorithm2e优先）
已添加\@addtoreset{algorithm}{chapter}命令
编号格式为「章节号-序号」（如3-2）
中文标题前缀为「算法」
交叉引用正确显示带章节号的算法编号
盲审模式下编号机制不受影响

通过本文方案，研究者可彻底解决算法编号混乱问题，使论文排版符合北京理工大学学术规范，让研究成果以更专业的形式呈现。BIThesis模板的灵活性与算法宏包的强大功能相结合，将为学术写作提供高效助力。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考