文档类、导言区与宏包
文档类决定文档的基本骨架;导言区放全局设置;宏包为文档增加能力。下面的示例展示了三者如何一起工作。
EasyLaTeX 编译器设置:XeLaTeX。中文文章使用 ctexart;示例额外使用 graphicx、xcolor 与 hyperref。
最小导言区
导言区位于 \documentclass 之后、\begin{document} 之前:
\documentclass[UTF8,a4paper,12pt]{ctexart}
% 这里是导言区:加载宏包和设置全局选项
\begin{document}
这里是正文。
\end{document}
正文中写的是要显示的内容;导言区写的是整份文档如何工作。不要把 \usepackage 放进正文。
选择文档类
\documentclass 的花括号指定文档类,方括号提供选项:
\documentclass[UTF8,a4paper,12pt]{ctexart}
| 文档类 | 适用场景 |
|---|---|
ctexart | 中文文章、课程作业、短报告 |
ctexrep | 中文报告,支持 \chapter |
ctexbook | 中文书籍或长篇文档,支持前言与章节 |
beamer | 幻灯片;中文配置应参考 Beamer 专题 |
不要为了得到 \chapter 而在短文章中改用 ctexbook。文档类首先表达文档类型,其次才是可用命令的多少。
加载宏包
使用 \usepackage 加载功能。以下三个宏包分别处理图片、颜色和链接:
\usepackage{graphicx} % \includegraphics
\usepackage{xcolor} % \textcolor、\colorbox 等颜色命令
\usepackage{hyperref} % 可点击的目录、引用和 URL
宏包名称不带 .sty 后缀。加载宏包不等于马上必须使用它;只有正文调用其命令时,才会产生对应效果。
设置文档信息
标题信息通常放在导言区,再在正文中用 \maketitle 输出:
\title{实验报告}
\author{张三}
\date{2026 年 7 月}
\begin{document}
\maketitle
\end{document}
\title 等命令只保存信息,不会自动排版标题;\maketitle 才会在当前位置生成标题区。
定义自己的命令
重复出现的短语或格式可以在导言区封装为命令:
\newcommand{\LaTeXcn}{\LaTeX{} 中文文档}
正文中使用:
本文介绍 \LaTeXcn 的基本写作方式。
这适合稳定、重复的内容。不要一开始把所有格式都封装成自定义命令;当重复确实出现时再抽取,阅读和排错会更容易。
加载顺序与边界
-
文档类必须是文件中的第一个 LaTeX 命令;
-
宏包和全局设置放在导言区;
-
hyperref通常放在大多数宏包之后,避免覆盖链接设置; -
同一功能优先选择一套默认宏包,避免同时加载互相重叠的方案;
-
修改学校、期刊或出版社提供的模板前,先阅读模板注释;不要随意删除其文档类和已有宏包。
完整示例
\documentclass[UTF8,a4paper,12pt]{ctexart}
\usepackage{graphicx}
\usepackage{xcolor}
\usepackage[colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
\title{导言区示例}
\author{张三}
\date{\today}
\newcommand{\LaTeXcn}{\LaTeX{} 中文文档}
\begin{document}
\maketitle
本文是一个 \textcolor{blue}{\LaTeXcn} 示例。
\href{https://www.latex-project.org/}{LaTeX Project} 是 LaTeX 的官方项目网站。
\end{document}