大型 LaTeX 项目如何管理？目录结构、分章节编译与命名规范
大型 LaTeX 项目的维护成本主要来自三处：改动落在哪个文件看不出来、编译要等多久、宏包散落导致的同名冲突。对应做法是固定文件职责、收拢宏包入口、缩小单次编译范围、统一命名规则。
大型 LaTeX 项目如何组织目录结构？
大型 LaTeX 项目包含多个章节、表格和图片文件时，首先要建立清晰的目录结构，让每个文件的职责一目了然。建议按文件用途划分目录，并让文件名与章节内容对应，方便定位和维护。
project/
├── main.tex % 文档类与章节顺序
├── preamble.tex % 宏包与自定义命令
├── chapters/
│ ├── intro.tex
│ ├── method.tex
│ └── results.tex
├── tables/ % \input 进来的表格源码
└── figures/
下面这份 main.tex 可以直接编译，前提是同目录下存在 preamble.tex 与 chapters/ 里的三个文件：
% main.tex
\documentclass[11pt]{article}
\input{preamble}
% 仅做章节预览时取消下一行注释；交付前保持注释
% \includeonly{chapters/method}
\begin{document}
\include{chapters/intro}
\include{chapters/method}
\include{chapters/results}
\end{document}
主文件不写正文，只保留文档类、\input 与章节顺序；改一章内容只需动 chapters/ 下的一个文件。
LaTeX 多文件项目如何统一管理宏包？
同一个宏包在不同文件中重复加载时容易出现选项冲突，日志报 Option clash for package ...，报错位置指向第二个加载它的文件。把全部宏包集中到 preamble.tex：
% preamble.tex —— 全文的宏包只在这里出现
\usepackage{amsmath,amssymb}
\usepackage{graphicx}
\usepackage{booktabs}
\usepackage[hidelinks]{hyperref}
preamble.tex 由主文件在 \begin{document} 之前 \input 进来。加载顺序也会影响结果，hyperref 通常放在最后；集中之后调整只改这一处，章节文件里不再出现 \usepackage。
单次编译变慢时：用 \includeonly 只编译改动的章节
章节变多后，不必每次都重新排版全文。在导言区加一行 \includeonly，列出本次要重新编译的章节；其余章节不排版。被省略章节的编号与交叉引用依赖已有辅助信息；不要假设这些信息会在每次平台任务中保留。
前提：章节必须用 \include 引入，\input 进来的内容不受 \includeonly 影响；被排除的章节此前至少完整编译过一次，否则其他地方引用它们时显示 ??。
% 只重新编译 method 一章
\includeonly{chapters/method}
副作用是本次只更新被包含章节的 .aux。改动如果改变了篇幅，被排除章节的页码可能停在上一版，交付前去掉这一行做一次完整编译，再确认目录与编号。
标签与文件命名不统一时：用前缀区分对象类型
| 对象 | 前缀 | 示例 |
|---|---|---|
| 章节 | sec: | \label{sec:method} |
| 图 | fig: | \label{fig:pipeline} |
| 表 | tab: | \label{tab:ablation} |
| 公式 | eq: | \label{eq:update} |
两个 \label 重名不会中断编译，只在日志里留一条 multiply-defined labels 提示，引用可能指向错误对象；统一前缀后可以按类型检索，把重名找出来。
浮动体里的 \label 要写在 \caption 之后。写反时编号照常生成，取到的却是上一个计数器，编译不报错，只在 PDF 里显示错误编号。
改动完成后核对：三个位置与常见日志提示
改完一处后核对三件事：\include 列表与实际文件是否对应、标签与引用是否一一对应、是否需要再做一次完整编译。
| 报错 | 触发原因 | 处理 |
|---|---|---|
LaTeX Warning: There were multiply-defined labels. | 两个 \label 重名 | 检索改名；编译两次，交叉引用才全部更新 |
LaTeX Warning: Reference 'fig:x' undefined | 标签未写入 .aux，或章节未完整编译过 | 完整编译一次；确认 \label 位于 \caption 之后 |
LaTeX Warning: Label(s) may have changed. | 本轮交叉引用与上一轮不一致 | 再编译一次，直到该提示消失 |
! LaTeX Error: Option clash for package hyperref. | 同一宏包在两个文件里以不同选项加载 | 把 \usepackage 集中到 preamble.tex |
! LaTeX Error: \include cannot be nested. | 章节文件内又用了 \include | 章节内改用 \input |
相关阅读：如何减少 LaTeX 项目中的重复代码？、LaTeX 编译失败怎么办？三步定位到出错的那一行、如何让 AI 更准确地修改 LaTeX，而不是越改 Bug 越多？。
总结
-
按职责分层：主文件只留骨架，章节、表格源码、图片各占一层；
-
宏包只留一个入口：
\usepackage全部写在preamble.tex； -
编译按章节缩小：
\includeonly只编改动的章节，交付前做一次完整编译； -
命名用前缀区分：
sec:/fig:/tab:/eq:，重名与失效引用都能检索出来。
文件较多、编译时间偏长时，可以把整个目录导入 EasyLaTeX 编辑器，编译入口按 main.tex 设置。