xpinyin会影响xeCJK的Autofallback机制

[Explorer-cc]

考虑下面的两个MWE：

\documentclass{article}
\usepackage[AutoFallBack]{xeCJK}
\setCJKmainfont{lmroman10-regular.otf}
\setCJKfallbackfamilyfont{\CJKrmdefault}{FandolSong-Regular.otf}

\begin{document}
China 中国

\end{document}

work.

然而如果引入 xpinyin：

\documentclass{article}
\usepackage[AutoFallBack]{xeCJK}
\setCJKmainfont{lmroman10-regular.otf}
\setCJKfallbackfamilyfont{\CJKrmdefault}{FandolSong-Regular.otf}
\usepackage{xpinyin}

\begin{document}
China 中国

China \xpinyin*{中国}
\end{document}

得到的效果如下：

终端的输出为：

$ xelatex test
This is XeTeX, Version 3.141592653-2.6-0.999998 (TeX Live 2026) (preloaded format=xelatex)
 restricted \write18 enabled.
entering extended mode
(./test.tex
LaTeX2e <2026-06-01>
L3 programming layer <2026-06-18>
(c:/texlive/2026/texmf-dist/tex/latex/base/article.cls
Document Class: article 2025/01/22 v1.4n Standard LaTeX document class
(c:/texlive/2026/texmf-dist/tex/latex/base/size10.clo))
(c:/texlive/2026/texmf-dist/tex/xelatex/xecjk/xeCJK.sty
(c:/texlive/2026/texmf-dist/tex/latex/l3kernel/expl3.sty
(c:/texlive/2026/texmf-dist/tex/latex/l3backend/l3backend-xetex.def))
(c:/texlive/2026/texmf-dist/tex/latex/ctex/ctexhook.sty)
(c:/texlive/2026/texmf-dist/tex/latex/l3packages/xtemplate/xtemplate.sty)
(c:/texlive/2026/texmf-dist/tex/latex/fontspec/fontspec.sty
(c:/texlive/2026/texmf-dist/tex/latex/l3packages/xparse/xparse.sty)
(c:/texlive/2026/texmf-dist/tex/latex/fontspec/fontspec-xetex.sty
(c:/texlive/2026/texmf-dist/tex/latex/base/fontenc.sty)
(c:/texlive/2026/texmf-dist/tex/latex/fontspec/fontspec.cfg)))
(c:/texlive/2026/texmf-dist/tex/xelatex/xecjk/xeCJK.cfg))
(c:/texlive/2026/texmf-dist/tex/latex/xpinyin/xpinyin.sty
(c:/texlive/2026/texmf-dist/tex/latex/xpinyin/xpinyin-database.def))
(./test.aux)
Missing character: There is no 中 (U+4E2D) in font [lmroman10-regular.otf]/OT:sc
ript=hani;language=dflt;!
Missing character: There is no 国 (U+56FD) in font [lmroman10-regular.otf]/OT:sc
ript=hani;language=dflt;!
[1] (./test.aux)

 *File List*
 article.cls    2025/01/22 v1.4n Standard LaTeX document class
  size10.clo    2025/01/22 v1.4n Standard LaTeX file (size option)
   xeCJK.sty    2026/07/06 v3.10.2 Typesetting CJK scripts with XeLaTeX
   expl3.sty    2026-06-18 L3 programming layer (loader) 
l3backend-xetex.def    2026-02-18 L3 backend support: XeTeX
ctexhook.sty    2026/07/04 v2.6.2 Document and package hooks (CTEX)
xtemplate.sty    2025-10-09 L3 Experimental prototype document functions
fontspec.sty    2025/09/29 v2.9g Font selection for XeLaTeX and LuaLaTeX
  xparse.sty    2025-10-09 L3 Experimental document command parser
fontspec-xetex.sty    2025/09/29 v2.9g Font selection for XeLaTeX and LuaLaTeX
 fontenc.sty    2025/07/18 v2.1d Standard LaTeX package
fontspec.cfg
   xeCJK.cfg    2026/07/06 v3.10.2 Configuration file for xeCJK package
 xpinyin.sty    2022/07/14 v3.1 Automatically add pinyin to Chinese characters
xpinyin-database.def    2022/07/14 v3.1 xpinyin database
 ***********

 )
Output written on test.pdf (1 page).
Transcript written on test.log.

[github-actions]

根因定位

已复现。问题出在 xpinyin 侧——\@@_CJKsymbol_hook: 无条件重选主字体，覆盖了 AutoFallBack 已切换好的 fallback 字体。

完整故障调用链

1. xeCJK 的 \xeCJK_fallback_symbol:NN（xeCJK.dtx L8119–8124）检测到字符不在主字体中 → \@@_fallback_symbol_aux:NN 切换到 fallback 字体 → 然后执行 \CJKsymbol {中}
2. 此时 xpinyin 已通过 \@@_replace_CJKsymbol_aux:（xpinyin.dtx L784–787）将 \CJKsymbol 替换为 \@@_CJKsymbol:n
3. \@@_CJKsymbol:n → \@@_make_pinyin_box:nnn（xpinyin.dtx L595）→ L601 调用 \@@_CJKsymbol_hook:
4. \@@_CJKsymbol_hook:（xpinyin.dtx L892–897）无条件调用 \xeCJK_select_font:
5. \xeCJK_select_font: → \@@_select_font:Nn（xeCJK.dtx L8727–8732）首先执行 \xeCJK_clear_fallback_font: 清除 fallback 状态，然后重新选择主 CJK 字体族
6. 之后 \@@_save_CJKsymbol:n {中} 在主字体（lmroman10-regular.otf）下输出 → Missing character

影响范围

仅在 \enablepinyin 或 \xpinyin*{…} 作用域内，且同时使用 AutoFallBack + fallback 字体时触发。不在 xpinyin 作用域内的 CJK 文字不受影响。

修复方向

问题在 xpinyin 的 \@@_CJKsymbol_hook: 不应无条件重选主字体。可能的方案：

• 在 \@@_make_pinyin_box:nnn 内部保存/恢复当前字体：进入 pinyin box 构造前记住当前已激活的字体（可能是 fallback 字体），\@@_CJKsymbol_hook: 中恢复到该字体而非重选主字体族
• 或让 \@@_CJKsymbol_hook: 在 fallback 状态下跳过字体重选：检查是否处于 fallback 切换后的状态

此问题涉及 xpinyin 字体选择核心路径，需要验证修复后在各种字体组合下（有/无 fallback、不同字体族）的正确性，建议手工修复。