脚注、边注与代码排版

脚注用于补充但不打断正文的信息，边注用于短提示，代码应按长度选择行内等宽字体、原样环境或带高亮的代码块。三者都应节制使用，避免压缩正文的阅读空间。

EasyLaTeX 编译器设置：XeLaTeX + ctex；边注示例使用 marginnote，代码块使用 listings。listings 对中文源代码支持有限，含中文注释的代码可改用 verbatim 或专用高亮方案。

添加脚注#

在需要补充说明的位置使用 \footnote{...}：

该术语采用行业常见定义\footnote{不同标准的表述可能略有差异。}。

LaTeX 会自动编号并把脚注排到页面底部。脚注应补充来源、例外或简短解释，不应承载一段新的论证。

拆分脚注标记和文字#

表格、标题等不能直接使用普通脚注的地方，可拆分标记和文字：

表格标题\footnotemark
...
\footnotetext{该数据经过四舍五入。}

两个命令需要处于同一页附近，并按出现顺序配对。复杂表格脚注应优先遵循目标模板或使用表格专用方案。

添加边注#

\marginpar 是 LaTeX 内置边注，\marginnote 更适合在当前位置放置短注释：

\usepackage{marginnote}

这个结论需要复核。\marginnote{待补充来源}

边注会占用页边距空间，双面文档还要考虑它出现在哪一侧。长边注会与页眉、脚注或其他边注冲突，因此只放简短关键词。

排版行内代码#

短命令、文件名或变量使用 \texttt：

主文件通常命名为 \texttt{main.tex}。

需要逐字显示且内容不含分隔符时可用 \verb|...|：

\verb|\section{标题}|

\verb 不能放在移动参数中，例如章节标题、图题和脚注；这些位置使用 \texttt 或专用宏包命令。

排版代码块#

少量原样文本使用 verbatim：

\begin{verbatim}
main.tex
figures/result.pdf
\end{verbatim}

需要编号、自动换行或语法高亮时使用 listings：

\usepackage{listings}
\usepackage{xcolor}
\lstset{
  basicstyle=\ttfamily\small,
  frame=single,
  breaklines=true
}

\begin{lstlisting}[language=Python]
total = sum(values)
print(total)
\end{lstlisting}

代码块应保留原有缩进，并在正文中说明它的输入、输出或作用，而不是只贴出一段无法运行的代码。

常见问题#

脚注跑到下一页#

这是页底空间不足的正常排版结果。缩短脚注、调整正文结构或让相关句子换页；不要用大量负间距强行拉回脚注。

边注与正文或其他边注重叠#

缩短边注，减少同页数量，或改用脚注。边注不适合密集注释和关键正文信息。

listings 中中文乱码#

listings 对 Unicode 和中文注释支持有限。英文代码可继续使用它；含中文的原样内容使用 verbatim，或采用项目模板已经配置的代码高亮工具。

完整示例#

\documentclass[UTF8,a4paper,12pt]{ctexart}
\usepackage{marginnote}
\usepackage{listings}
\usepackage{xcolor}
\lstset{basicstyle=\ttfamily\small, frame=single, breaklines=true}

\begin{document}

使用 \texttt{main.tex} 作为主文件\footnote{项目的唯一编译入口。}。
\marginnote{编译前检查引擎}

\begin{lstlisting}[language=Python]
total = sum(values)
print(total)
\end{lstlisting}

\end{document}