[Bug]: 未使用listing宏包警告LaTeX: Command `\thelstlisting' already defined -- not changed.

[hours-qing-gh]

发生了什么？

如果自己用了 listing 宏包，警告消失；没用时反而会出现

你期望的结果

No response

问题复现的步骤（或者截图）

使用vscode会出现上述警告，其他平台未测试

BIThesis 模板

硕博·学位论文 — graduate-thesis

操作系统或平台

Windows

LaTeX 发行版以及发行年份

Texlive 2025

日志信息（可选）

[YDX-2147483647]

listing 相关背景

• 代码块caption #338 现在死灰复燃了，因为重写\thelstlisting未生效。
• 4c2757f fix: fix non-effective listings numbering. fix: fix non-effective listings numbering. #341
• f059c30 feat: add listings caption support. Regular Maintainance: year 2021. #87

原因

好像是\RequirePackage{listings}之前有\AtBeginDocument{…}导致的。把\AtBeginDocument删掉，或者把\RequirePackage{listings}提前，警告就没有了，并且重写\thelstlisting也生效了。

BIThesis/bithesis.dtx

Lines 706 to 718 in 25d9f7a

	autoref / algo .code:n = {
	\AtBeginDocument{
	% 定义算法标题
	% 针对 algorithm 宏包
	\tl_set:Nn \ALG@name {#1}
	% 针对 algorithm2e 宏包
	\tl_set:Nn \algorithmcfname {#1}
	% 定义算法的 autoref
	% algorithm2e 宏包会覆写它，所以我们必须AtBeginDocument时再修改
	\tl_set:Nn \algorithmautorefname {#1}
	}
	},

6d45404
#445

以下超小bithesis.cls也能生成这个问题：

\RequirePackage{expl3}

\ProvidesExplClass{bithesis}
{2025-01-03}{3.8.1}{BIT Thesis Templates}

\LoadClass{book}

% 加上下面这行便正常，不加便警告且重写无效
% \RequirePackage{listings}

\AtBeginDocument{
  \cs_gset:Npn \thelstlisting {\thechapter-\arabic{lstlisting}}
}

\endinput