跳转到正文
EasyLaTeXDocs

文档类、导言区与宏包

文档类决定文档的基本骨架;导言区放全局设置;宏包为文档增加能力。下面的示例展示了三者如何一起工作。

EasyLaTeX 编译器设置:XeLaTeX。中文文章使用 ctexart;示例额外使用 graphicx、xcolor 与 hyperref。

最小导言区

导言区位于 \documentclass 之后、\begin{document} 之前:

latex
\documentclass[UTF8,a4paper,12pt]{ctexart}

% 这里是导言区:加载宏包和设置全局选项

\begin{document}

这里是正文。

\end{document}

正文中写的是要显示的内容;导言区写的是整份文档如何工作。不要把 \usepackage 放进正文。

选择文档类

\documentclass 的花括号指定文档类,方括号提供选项:

latex
\documentclass[UTF8,a4paper,12pt]{ctexart}
文档类适用场景
ctexart中文文章、课程作业、短报告
ctexrep中文报告,支持 \chapter
ctexbook中文书籍或长篇文档,支持前言与章节
beamer幻灯片;中文配置应参考 Beamer 专题

不要为了得到 \chapter 而在短文章中改用 ctexbook。文档类首先表达文档类型,其次才是可用命令的多少。

加载宏包

使用 \usepackage 加载功能。以下三个宏包分别处理图片、颜色和链接:

latex
\usepackage{graphicx} % \includegraphics
\usepackage{xcolor}   % \textcolor、\colorbox 等颜色命令
\usepackage{hyperref} % 可点击的目录、引用和 URL

宏包名称不带 .sty 后缀。加载宏包不等于马上必须使用它;只有正文调用其命令时,才会产生对应效果。

设置文档信息

标题信息通常放在导言区,再在正文中用 \maketitle 输出:

latex
\title{实验报告}
\author{张三}
\date{2026 年 7 月}
latex
\begin{document}
\maketitle
\end{document}

\title 等命令只保存信息,不会自动排版标题;\maketitle 才会在当前位置生成标题区。

定义自己的命令

重复出现的短语或格式可以在导言区封装为命令:

latex
\newcommand{\LaTeXcn}{\LaTeX{} 中文文档}

正文中使用:

latex
本文介绍 \LaTeXcn 的基本写作方式。

这适合稳定、重复的内容。不要一开始把所有格式都封装成自定义命令;当重复确实出现时再抽取,阅读和排错会更容易。

加载顺序与边界

  • 文档类必须是文件中的第一个 LaTeX 命令;

  • 宏包和全局设置放在导言区;

  • hyperref 通常放在大多数宏包之后,避免覆盖链接设置;

  • 同一功能优先选择一套默认宏包,避免同时加载互相重叠的方案;

  • 修改学校、期刊或出版社提供的模板前,先阅读模板注释;不要随意删除其文档类和已有宏包。

完整示例

latex
\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}
文档类、导言区与宏包 | EasyLaTeX | EasyLaTeX