企业官网建设流程全解析

你有没有过这样的经历：花了一下午时间，用 Word 或 PowerPoint 精心排版了一份数学讲义，公式漂亮，图文并茂。发给学生或同事后，对方一打开，公式错位了，字体变了，页码乱了，甚至直接报错打不开。你不得不花更多时间去解释“请安装这个字体”、“请用这个版本的软件打开”，或者干脆说“算了，我发你 PDF 吧”。

这种挫败感，是很多内容创作者，尤其是理工科教师、研究者和学生都经历过的。我们真正想投入时间的是内容本身——那些精妙的推导、严谨的定义、清晰的图解——而不是和排版软件搏斗。于是，一个名字开始频繁出现：LaTeX。它被传颂为“学术排版的黄金标准”，但同时也被贴上了“学习曲线陡峭”、“像在编程”的标签，让许多想尝试的人望而却步。

今天，我们不谈那些宏大的概念，就从最实际的需求出发：如何用 LaTeX 制作一份真正好用、省心、且能长期复用的数学讲义？这篇文章不会是一份冰冷的命令手册，而是一次从“为什么用 LaTeX”到“如何高效使用”的完整实践复盘。我会带你绕过那些新手最容易掉进去的坑，把 LaTeX 从一个“神秘的排版语言”，变成你手中一个可靠、高效的生产力工具。

1. 为什么是 LaTeX？它解决的远不止是“公式漂亮”

很多人对 LaTeX 的第一印象是“打数学公式很厉害”。这没错，但它真正的价值远不止于此。LaTeX 解决的核心痛点是“内容与格式的彻底分离”和“排版的确定性与可复用性”。

想象一下，你用普通文档编辑器写讲义。你要操心字体大小、行间距、公式编号、图表位置、参考文献格式……每调整一个地方，都可能引发连锁反应。而 LaTeX 让你用纯文本写下内容和结构指令，编译后由引擎自动生成格式完美的文档。这意味着：

• 一次编写，处处一致：你的.tex源文件是纯文本，在任何系统、任何电脑上，只要安装了 LaTeX 环境，编译出来的 PDF 格式都完全一样。你再也不用担心“在我电脑上好好的，怎么到你那就乱了”。
• 专注于内容逻辑：你可以用\section{导数}、\begin{equation}这样的语义化命令来组织内容，而不是用鼠标去点击“标题1”、“插入公式”。你的写作流程更接近思考本身。
• 自动化处理繁琐细节：公式自动编号、交叉引用自动更新、目录自动生成、参考文献自动按格式排列。当你在第50页引用了第3页的公式(3.5)，之后在第10页又插入了一个新公式，所有编号和引用都会自动调整，绝不会出错。
• 强大的数学排版能力：这确实是 LaTeX 的看家本领。从简单的上下标、分式、积分，到复杂的矩阵、多行公式对齐、自定义算子，LaTeX 的数学模式提供了一套极其精确、优雅的排版方案，这是任何“所见即所得”编辑器难以媲美的。

所以，选择 LaTeX 制作数学讲义，你不是在选择一个“公式编辑器”，而是在选择一套可靠的内容生产工作流。它初期需要一点学习投入，但回报是长期的效率提升和格式上的绝对安心。

2. 跨越第一道门槛：环境搭建与编辑器的选择

对于新手，最大的障碍往往不是 LaTeX 语法，而是“如何开始”。面对“TeX Live”、“MiKTeX”、“MacTeX”、“Overleaf”、“VSCode + LaTeX Workshop”这些名词，很容易不知所措。我们的原则是：选择最省心、最能让你快速看到成果的路径。

2.1 发行版安装：TeX Live 是稳妥的起点

LaTeX 不是一个软件，而是一个由众多宏包（功能模块）组成的系统。你需要先安装一个“发行版”，它包含了引擎、宏包和字体等所有必需品。

• Windows/Mac/Linux 通用推荐：TeX Live
  • 为什么选它：它是目前最全面、维护最积极的跨平台发行版。一次安装，基本包含了你会用到的所有宏包，避免了后续频繁联网安装的麻烦。
  • 安装建议：访问 TeX Live 官网 或使用更快的国内镜像（如清华镜像站）。安装程序较大（几个GB），需要一些时间，但这是一劳永逸的投资。对于 Windows 用户，安装时记得勾选“将 TeX Live 添加到系统路径”的选项。
• Windows 特供：MiKTeX
  • 特点：它采用“按需安装”模式，初始安装包小，只在编译时自动下载缺少的宏包。适合硬盘空间紧张，且网络环境好的用户。
  • 潜在问题：如果遇到网络问题或特定宏包服务器不可用，编译会卡住。对于需要稳定离线工作的场景，不如 TeX Live 省心。

注意：不要从名字里带“CTeX”的套装开始。它们集成了中文支持，但版本可能较旧，且修改了部分默认行为，容易与主流教程和宏包产生兼容性问题。中文支持我们可以用更现代、更标准的方式解决。

2.2 编辑器选择：VSCode + LaTeX Workshop 是当前最佳组合

过去你可能听说 WinEdt、TeXworks 或专用 IDE。但现在，我强烈推荐Visual Studio Code (VSCode)配合LaTeX Workshop插件。

• 为什么是 VSCode？

  1. 免费、强大、生态好：它本身是一个优秀的代码编辑器，轻量且功能强大。
  2. 一体化体验：LaTeX Workshop 插件提供了语法高亮、代码补全、一键编译、实时预览PDF、错误跳转、公式预览等几乎所有你需要的功能。
  3. 便于管理项目：你可以用 VSCode 的文件夹管理功能，轻松组织讲义的多个.tex文件、图片、数据等。
  4. 未来兼容性：即使你以后要写代码、做笔记（用 Markdown），也无需切换工具。

• 如何设置 VSCode 环境？

  1. 安装 Visual Studio Code 。
  2. 在扩展商店中搜索并安装LaTeX Workshop。
  3. 基本安装后，你打开一个.tex文件，左侧活动栏就会出现 TeX 图标。点击它，你就可以看到编译、预览等按钮。

• 关键配置（解决常见问题）：

  • 切换编译引擎：LaTeX Workshop 默认可能使用latexmk。对于包含中文或需要生成参考文献的文档，更推荐使用XeLaTeX或LuaLaTeX引擎。你可以在 VSCode 的设置中 (settings.json) 添加或修改：

    "latex-workshop.latex.tools": [ { "name": "xelatex", "command": "xelatex", "args": [ "-synctex=1", "-interaction=nonstopmode", "-file-line-error", "%DOC%" ] }, { "name": "latexmk", "command": "latexmk", "args": [ "-synctex=1", "-interaction=nonstopmode", "-file-line-error", "-xelatex", "%DOC%" ] } ], "latex-workshop.latex.recipes": [ { "name": "xelatex -> bibtex -> xelatex*2", "tools": ["xelatex", "bibtex", "xelatex", "xelatex"] } ]

    这样你就可以在 VSCode 的 TeX 侧边栏选择不同的“配方”进行编译。
  • 清理辅助文件：编译会产生很多.aux,.log,.out等中间文件。LaTeX Workshop 有清理按钮，也可以配置自动清理。

备选方案：Overleaf如果你不想在本地安装任何东西，或者需要在线协作， Overleaf 是一个优秀的云端 LaTeX 编辑器。它开箱即用，内置了大量模板。缺点是依赖网络，处理大量图片或复杂编译时可能稍慢，且高级功能需要付费。

结论：对于长期、严肃的讲义编写，本地 TeX Live + VSCode的组合提供了最可控、最强大、最自由的环境。花半小时配置好，后续几年都会受益。

3. 从零到一：构建你的第一个数学讲义框架

现在，让我们动手创建一个最小可用的讲义框架。我们将遵循“先跑通，再优化”的原则。

3.1 文档类型与基础设置

创建一个新文件lecture.tex，输入以下内容：

% !TEX program = xelatex % 告诉编辑器默认使用 XeLaTeX 编译 \documentclass[12pt, a4paper]{article} % 文档类：文章，12磅字，A4纸 % ========== 宏包加载区 ========== \usepackage{amsmath, amssymb, amsthm} % 数学核心宏包：公式、符号、定理环境 \usepackage{graphicx} % 插入图片 \usepackage{hyperref} % 让目录、引用可点击跳转 \usepackage{xcolor} % 使用颜色 \usepackage{geometry} % 轻松设置页边距 \geometry{left=2.5cm, right=2.5cm, top=2.5cm, bottom=2.5cm} % 设置页边距 % ========== 中文字体支持 (关键！) ========== \usepackage{fontspec} % XeLaTeX 必须 \setmainfont{TeX Gyre Termes} % 西文主字体，优雅的 Times New Roman 替代 \setsansfont{Arial} % 无衬线字体 \setmonofont{Cascadia Code} % 等宽字体，用于代码 \usepackage{xeCJK} % 中日韩文字支持 \setCJKmainfont{SimSun} % 设置中文字体为宋体 (Windows)。Mac可用 STSong, Linux可用文泉驿等 % \setCJKmainfont{SimSun}[AutoFakeBold=3] % 如果需要伪粗体可以这样设置 % ========== 标题信息 ========== \title{微积分讲义：导数与微分} \author{你的名字} \date{\today} % 自动使用当前日期 % ========== 文档开始 ========== \begin{document} \maketitle % 生成标题 \tableofcontents % 生成目录 \section{导数的概念} % 一级章节 \subsection{变化率与切线斜率} % 二级章节 导数的本质是函数在某一点处的瞬时变化率，几何上对应的是曲线在该点处切线的斜率。 给定函数 $y = f(x)$，在点 $x_0$ 处的导数定义为： \begin{equation} % 带编号的公式环境 f'(x_0) = \lim_{\Delta x \to 0} \frac{f(x_0 + \Delta x) - f(x_0)}{\Delta x} \end{equation} 这里，$\Delta x$ 是自变量的增量，$\Delta y = f(x_0 + \Delta x) - f(x_0)$ 是因变量的增量。当 $\Delta x$ 无限趋近于0时，比值 $\Delta y / \Delta x$ 的极限就是导数。 \subsection{导函数} 如果函数 $y=f(x)$ 在区间 $I$ 内每一点都可导，则称 $f(x)$ 在 $I$ 内可导。这时，对于 $I$ 内每一个 $x$，都对应一个导数值 $f'(x)$，这样就构成了一个新的函数，称为 $f(x)$ 的导函数，记作 $f'(x)$，$y'$ 或 $\frac{dy}{dx}$。 常见函数的导数公式： \begin{itemize} \item $(C)' = 0$ （常数导数为零） \item $(x^n)' = n x^{n-1}$ （幂函数） \item $(\sin x)' = \cos x$ \item $(\cos x)' = -\sin x$ \item $(e^x)' = e^x$ \item $(\ln x)' = \frac{1}{x}$ \end{itemize} \section{微分及其应用} \subsection{微分的定义} 设函数 $y=f(x)$ 在点 $x_0$ 处可导，则称 $f'(x_0) \Delta x$ 为函数在点 $x_0$ 处相应于自变量增量 $\Delta x$ 的微分，记作 $dy$，即 \[ % 不带编号的公式环境 dy = f'(x_0) \Delta x \] 通常将自变量 $x$ 的增量 $\Delta x$ 称为自变量的微分，记作 $dx$，即 $dx = \Delta x$。于是函数的微分可写作： \[ dy = f'(x) dx \] 从而有 $\frac{dy}{dx} = f'(x)$。这表明，导数就是微分之商，故导数也称为“微商”。 % ========== 文档结束 ========== \end{document}

保存文件，在 VSCode 中点击编译按钮（或使用快捷键Ctrl+Alt+B）。如果一切顺利，你将得到一个包含标题、目录、章节、数学公式和列表的 PDF 文件。

这个框架的意义：它不是一个“Hello World”，而是一个包含了数学讲义核心要素的实用起点。你后续所有的内容，都可以在这个框架上添加。

3.2 关键元素详解与避坑指南

1. 文档类\documentclass：

   • article适合短文、讲义、报告。对于很长的书籍，可以考虑book或report。
   • [12pt]设置基础字号，a4paper设置纸张。这是最常用的组合。

2. 宏包\usepackage：

   • amsmath, amssymb, amsthm：数学三件套，必须加载。amsmath提供了align,gather等强大的多行公式环境；amssymb提供了丰富的数学符号；amsthm提供了theorem,proof等定理证明环境。
   • graphicx：插入图片，支持\includegraphics命令。
   • hyperref：强烈建议始终加载。它让 PDF 中的目录、参考文献引用、公式编号引用都变成可点击的超链接，极大提升了阅读体验。通常放在所有宏包的最后（除了极少数特殊情况）。
   • geometry：方便地调整页边距，比直接用\setlength更直观。

3. 中文字体支持（重中之重）：

   • 这是新手最容易出错的地方。我们使用了fontspec和xeCJK宏包，并指定了XeLaTeX引擎（通过文件第一行的% !TEX program = xelatex或编译时选择）。这是现代 LaTeX 处理中文的推荐方式。
   • \setCJKmainfont{SimSun}：这里设置了中文字体。你需要根据你的操作系统替换SimSun为系统里有的中文字体名。例如：
     • Windows:SimSun(宋体),Microsoft YaHei(微软雅黑),KaiTi(楷体)
     • macOS:STSong(华文宋体),STHeiti(华文黑体),PingFang SC(苹方)
     • Linux:WenQuanYi Micro Hei(文泉驿微米黑),Noto Sans CJK SC
   • 如何查找字体名？在系统字体文件夹里看到的文件名不一定是在 LaTeX 里使用的名字。一个可靠的方法是，在 TeX 文档中尝试编译，如果字体找不到，编译日志 (.log文件) 里通常会列出系统可用的字体名，你可以从中挑选。

4. 数学公式环境：

   • equation：单个带编号的公式。
   • \[ ... \]或equation*：不带编号的公式。
   • 行内公式用$ ... $。
   • 更复杂的多行对齐，我们将在下一章详细展开。

4. 数学讲义的灵魂：高效、优雅地排版公式

一份数学讲义的核心是公式。LaTeX 的数学模式功能极其强大，但掌握几个关键环境，就能解决 95% 的需求。

4.1 基础语法与符号

确保你已经加载了amsmath宏包。

• 上下标：x^2,a_n,x^{2y},a_{i,j}
• 分式：\frac{分子}{分母}。行内公式分式可能较小，可以用\dfrac强制显示为展示样式。
• 根号：\sqrt{x},\sqrt[n]{x}
• 求和、积分、极限：

  \sum_{i=1}^{n} a_i \quad \int_{a}^{b} f(x)\,dx \quad \lim_{x \to \infty} f(x)

  \,插入一个小的空格，让公式更美观。
• 常见符号：
  • 希腊字母：\alpha,\beta,\Gamma,\Delta,\pi,\omega
  • 运算符：\times(乘),\cdot(点乘),\div(除),\pm(加减),\mp(减加)
  • 关系符：\leq(≤),\geq(≥),\neq(≠),\approx(≈),\equiv(≡),\in(属于),\subset(子集)
  • 箭头：\to(→),\mapsto(↦),\implies(⇒),\iff(⇔)
  • 点：\dots(…),\cdots(⋯),\vdots(⋮),\ddots(⋱)

4.2 多行公式与对齐：align环境

这是排版推导过程最常用的环境。它允许你在等号或其他符号处对齐。

\begin{align} % 每行都有编号 (a+b)^2 &= a^2 + 2ab + b^2 \label{eq:square} \\ % \label 用于后面引用 (a-b)^2 &= a^2 - 2ab + b^2 \\ (a+b)(a-b) &= a^2 - b^2 \end{align}

使用&来指定对齐点（通常放在等号前），\\换行。\label{eq:square}给公式打上标签，之后可以用\eqref{eq:square}来引用它，编号会自动更新。

如果不需要某行编号，在\\前加上\notag。如果所有行都不需要编号，使用align*环境。

4.3 多行公式居中：gather环境

当多行公式不需要对齐，只是简单地居中排列时使用。

\begin{gather} \sin^2 x + \cos^2 x = 1 \\ \tan x = \frac{\sin x}{\cos x} \quad (x \neq \frac{\pi}{2} + k\pi) \end{gather}

4.4 分段函数与大括号：cases环境

f(x) = \begin{cases} x^2 + 1, & \text{if } x \geq 0, \\ -x, & \text{if } x < 0. \end{cases}

\text{}命令用于在数学模式中插入正体文本。

4.5 矩阵与行列式

% 需要 amsmath 宏包 矩阵： \[ \begin{pmatrix} % 圆括号矩阵，还有 bmatrix[], Bmatrix{}, vmatrix|, Vmatrix‖ a & b \\ c & d \end{pmatrix} \] 行列式： \[ \begin{vmatrix} a & b \\ c & d \end{vmatrix} = ad - bc \]

4.6 定理、定义、引理环境

使用amsthm宏包可以方便地定义。

\newtheorem{theorem}{定理}[section] % 在 \begin{document} 前定义 \newtheorem{definition}[theorem]{定义} \newtheorem{lemma}[theorem]{引理} \newtheorem{example}[theorem]{例} % 在文档中使用 \begin{theorem}[中值定理] 如果函数 $f(x)$ 在闭区间 $[a,b]$ 上连续，在开区间 $(a,b)$ 内可导，则在 $(a,b)$ 内至少存在一点 $\xi$，使得 \[ f'(\xi) = \frac{f(b)-f(a)}{b-a}. \] \end{theorem} \begin{proof} 证明过程... \end{proof}

[section]参数使得定理编号包含章节号（如 Theorem 1.1）。[theorem]参数使得定义、引理等与定理共用计数器。

5. 超越基础：让讲义更专业、更易用的进阶技巧

当基本内容搞定后，以下几个技巧能显著提升讲义的可用性和你的工作效率。

5.1 自动化交叉引用：\label和\ref

这是 LaTeX 最强大的功能之一。你可以为章节、公式、图表、定理等任何带编号的对象打上标签，然后在别处引用，LaTeX 会自动处理编号。

\section{导数的应用}\label{sec:application} ... 在章节 \ref{sec:application} 中，我们将看到 ... ... 根据公式 \eqref{eq:square} 可知 ... ... 如图 \ref{fig:derivative} 所示 ... \begin{figure}[htbp] \centering \includegraphics[width=0.8\textwidth]{derivative.png} \caption{导数的几何意义}\label{fig:derivative} \end{figure}

规则：先定义（\label），后引用（\ref）。通常\label紧跟在\section,\begin{equation},\begin{figure},\begin{table}等命令之后。编译两次才能让引用编号正确显示（第一次生成.aux文件记录标签，第二次读取并替换）。

5.2 插入并管理图片

1. 基本插入：

   \usepackage{graphicx} ... \begin{figure}[htbp] % 位置参数：h(此处), t(顶部), b(底部), p(独立一页) \centering \includegraphics[width=0.5\textwidth]{images/myplot.pdf} % 推荐使用矢量图 PDF/EPS \caption{这是一张示意图}\label{fig:demo} \end{figure}

2. 图片格式：优先使用PDF, EPS, SVG等矢量格式，放大不失真。位图如 PNG, JPG 要确保分辨率足够（通常 300 DPI 以上）。
3. 路径管理：可以将所有图片放在一个子文件夹（如figures/）中，然后用\graphicspath{{figures/}}命令设置搜索路径。
4. 并排图片：使用subfigure或更现代的subcaption宏包。

   \usepackage{subcaption} ... \begin{figure}[htbp] \centering \begin{subfigure}[b]{0.45\textwidth} \centering \includegraphics[width=\textwidth]{fig1.pdf} \caption{情况一} \label{fig:sub1} \end{subfigure} \hfill \begin{subfigure}[b]{0.45\textwidth} \centering \includegraphics[width=\textwidth]{fig2.pdf} \caption{情况二} \label{fig:sub2} \end{subfigure} \caption{两种情况的对比} \label{fig:two} \end{figure}

5.3 管理参考文献（BibTeX）

手动管理参考文献是噩梦。BibTeX 是 LaTeX 的参考文献管理系统。

1. 创建.bib文件：例如refs.bib，内容如下：

   @book{stewart2020calculus, title={Calculus: Early Transcendentals}, author={Stewart, James}, year={2020}, publisher={Cengage Learning} } @article{newton1687philosophiae, title={Philosophi{\ae} Naturalis Principia Mathematica}, author={Newton, Isaac}, year={1687}, journal={Royal Society} }

   每个条目有一个唯一的键（如stewart2020calculus），用于在文中引用。条目信息可以从 Google Scholar、出版社网站等地方直接导出 BibTeX 格式。

2. 在文中引用：

   微积分的基本思想可以追溯到牛顿和莱布尼茨\cite{newton1687philosophiae}。现代教材如\cite{stewart2020calculus}对此有详细阐述。

3. 设置参考文献样式并编译： 在文档末尾、\end{document}之前加入：

   \bibliographystyle{plain} % 样式：plain, abbrv, alpha, unsrt 等 \bibliography{refs} % 你的 .bib 文件名（不带后缀）

4. 编译流程：对于包含 BibTeX 的文档，需要按顺序编译多次：

   • xelatex lecture.tex(生成.aux文件，记录引用信息)
   • bibtex lecture.aux(处理.bib文件，生成.bbl文献列表)
   • xelatex lecture.tex(将文献列表插入文档)
   • xelatex lecture.tex(解决交叉引用，最终定型) 在 VSCode 中，我们之前配置的xelatex -> bibtex -> xelatex*2配方会自动完成这个过程。

5.4 使用模板和自定义命令

• 利用模板：不要从零开始设计复杂的版式。网上有大量优秀的 LaTeX 模板（如 Overleaf 的 Gallery）。找到一个接近你需求的模板（例如大学或会议提供的官方模板），在其基础上修改，能节省大量时间。
• 自定义命令：如果你发现自己反复输入一长串复杂的公式或格式，可以定义自己的命令。

  % 在导言区定义 \newcommand{\R}{\mathbb{R}} % 实数集 \newcommand{\diff}{\mathop{}\!\mathrm{d}} % 微分算子 d，前面加\!微调间距 \newcommand{\pdv}[2]{\frac{\partial #1}{\partial #2}} % 偏导数简写 \newcommand{\vect}[1]{\mathbf{#1}} % 向量 % 在正文中使用 设 $x \in \R$，则函数的微分为 $\diff y = f'(x) \diff x$。 偏导数 $\pdv{u}{t}$ 表示... 向量 $\vect{v}$ 的方向是...

  这能让你的源代码更简洁、易读，并且方便全局修改。

6. 从单文件到工程化：大型讲义的组织与协作

当你的讲义超过几十页，或者包含大量图片、代码、章节时，把所有内容塞进一个.tex文件会变得难以管理。这时，你需要将项目工程化。

6.1 使用\input或\include拆分文件

将不同的章节或部分放在独立的.tex文件中，在主文件中组织它们。

• \input{filename}：简单地将文件内容插入，就像直接粘贴一样。适合组织代码片段、通用设置。

  % 主文件 main.tex \input{preamble.tex} % 导言区设置 \begin{document} \input{chap1.tex} \input{chap2.tex} \end{document}

• \include{filename}：更智能。它会在每个\include的文件前后插入\clearpage，并且可以配合\includeonly命令选择性编译某些章节，加快调试速度。适合组织独立的章节。

  \includeonly{chap1,chap3} % 只编译第1章和第3章 \begin{document} \include{chap1} % 这些文件不要加 .tex 后缀 \include{chap2} \include{chap3} \end{document}

6.2 建立清晰的项目结构

一个良好的项目文件夹可能如下所示：

my_lecture/ ├── main.tex # 主文档 ├── preamble.tex # 所有宏包和自定义命令 ├── references.bib # 参考文献数据库 ├── figures/ # 存放所有图片 │ ├── derivative.pdf │ └── plot1.png ├── chapters/ # 存放各章节 │ ├── 01-intro.tex │ ├── 02-derivative.tex │ └── 03-integral.tex ├── appendices/ # 附录 │ └── appendixA.tex └── output/ # 编译输出目录（可在编译脚本中设置） └── main.pdf

使用 VSCode 打开整个my_lecture文件夹作为工作区，可以方便地管理所有文件。

6.3 版本控制：Git

LaTeX 源文件是纯文本，非常适合用 Git 进行版本控制。这不仅能备份你的工作，还能清晰地记录每一次修改（比如修正了一个公式错误，添加了一幅图），方便回溯和协作。

1. 在项目根目录初始化 Git：git init
2. 创建.gitignore文件，忽略编译产生的中间文件：

   *.aux *.log *.out *.toc *.bbl *.blg *.synctex.gz *.fdb_latexmk *.fls *.pdf !main.pdf # 除了最终的主PDF

3. 将重要的.tex,.bib, 图片文件等加入版本控制。
4. 定期提交 (git commit)，并用清晰的提交信息说明修改内容。

6.4 持续集成与自动化编译

对于团队协作或希望确保每次提交都能生成最新 PDF 的情况，可以考虑使用持续集成服务。例如，将项目托管在 GitHub 上，配置 GitHub Actions，使得每次推送代码后，自动在云端编译 LaTeX 项目，并将生成的 PDF 作为发布产物。这确保了任何人拿到源码，都能得到完全一致的编译结果。

7. 常见问题排查与长期维护建议

即使一切设置正确，你仍可能遇到编译错误或奇怪的排版问题。以下是一个通用的排查思路：

1. 看日志文件 (.log)：编译失败时，控制台输出的错误信息往往只是最后一部分。打开生成的.log文件，搜索!或Error，查看更详细的上下文。错误信息通常能精确定位到行号和问题。
2. 检查括号和环境的匹配：{},[],\begin{}...\end{}必须严格配对。使用编辑器的括号高亮功能。
3. 检查特殊字符：在 LaTeX 中，#,$,%,&,_,{,}等字符有特殊含义。如果要在正文中输出它们，需要加反斜杠转义，如\$,\%,\_。
4. 宏包冲突：有时加载的宏包顺序不对或功能冲突会导致错误。尝试注释掉最近添加的宏包，或者调整加载顺序。hyperref宏包通常建议最后加载（除了少数如cleveref等需要在其后加载的）。
5. 缓存问题：如果引用编号、目录或参考文献显示不正确，尝试连续编译两次，并清理所有辅助文件 (*.aux,*.toc,*.bbl等) 后重新编译。
6. 字体问题：中文乱码或缺失，几乎都是字体设置问题。确认\setCJKmainfont里的字体名在你的系统中确实存在且可用。可以尝试换一个系统自带字体。

长期维护建议：

• 保持简洁：不要过度使用复杂的宏包和 hack。代码越简单，未来出问题的概率越低，也越容易移植。
• 写好注释：在.tex文件中用%添加注释，说明复杂代码块的作用或待办事项。
• 定期备份：除了本地，利用 Git 和云端仓库（GitHub, GitLab, Gitee）进行备份。
• 建立个人宏包：将你常用的自定义命令、颜色定义、定理环境设置等集中写在一个mystyle.sty文件中，然后在不同项目的导言区用\usepackage{mystyle}加载，实现配置的复用。

回到最初的问题，用 LaTeX 制作数学讲义，本质上是在构建一套可预测、可复用、专注于内容本身的创作系统。它初期的学习成本，会转化为后期巨大的时间节省和格式上的绝对掌控力。你不必一次性掌握所有高级功能，从今天这个能编译通过的框架开始，每次添加一个新功能（比如插入一张图、引用一篇文献、定义一个定理环境），你就在向更高效的工作流迈进一步。最终，LaTeX 将不再是一个需要刻意使用的工具，而成为你表达数学思想时，自然流淌出的语言。