pgfopts含空格参数与babel冲突编译报错问题求助

原因分析 #

这是pgfopts与babel加载时机冲突导致的已知问题：pgfopts处理带空格的选项值时，若babel在选项解析前加载，babel的字符初始化逻辑会干扰pgfopts对带空格参数的分组解析，导致文本提前输出（未进入document环境），从而触发Missing \begin{document}错误。

解决方案 #

1. 调整babel加载顺序 #

在类文件中先处理所有pgfopts选项，再加载babel，确保选项值已被正确存储后，再让babel初始化语言环境。

2. 正确存储选项值而非直接执行命令 #

避免在pgfopts的选项处理代码中直接调用\title{#1}这类会产生文本输出的命令，先将值存入变量，后续在合适时机（比如类初始化完成后或document环境内）再使用。

示例代码 #

类文件 myPlanning.cls #

\NeedsTeXFormat{LaTeX2e}
\ProvidesClass{myPlanning}[2024/05/20 Custom planning class]

% 加载pgfopts包
\RequirePackage{pgfopts}

% 定义选项键，将值存储到内部变量
\pgfkeys{
  /myPlanning/.cd,
  lang/.store in=\my@lang,
  lang=english, % 设置默认语言
  title/.store in=\my@title,
  title={Default Title}, % 设置默认标题
}

% 优先处理所有文档类传入的选项
\ProcessPgfOptions{/myPlanning}

% 处理完选项后再加载babel
\RequirePackage[\my@lang]{babel}

% 加载基础文档类
\LoadClass{article}

% 定义输出标题的示例命令
\newcommand{\printtitle}{\textbf{\my@title}}

测试文档 #

\documentclass[title={truc bidul},lang=french]{myPlanning}

\begin{document}
\printtitle
\end{document}

额外说明 #

如果需要使用LaTeX默认的标题机制，可在类文件中添加以下代码，在document环境开始时设置全局标题：

\AtBeginDocument{\title{\my@title}}

这样既避免了过早执行命令引发的错误，又能正常调用\maketitle等默认命令。

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