一个面向中文初学者的可编译 LaTeX 项目：从第一份中文文档出发，逐步掌握文字排版、数学公式、三线表、图片、定理、参考文献、多文件项目与 Beamer 演示文稿。

查看教程 PDF · 下载最新 Release · 查看 Beamer 示例

• 边读边改：八个章节都是真实的 .tex 文件，可以直接修改并重新编译。
• 源码与效果对照：在 VS Code 左侧阅读源码，在右侧查看对应 PDF。
• 面向中文写作：使用 XeLaTeX 与 ctex，覆盖常见中文排版需求。
• 从文章到演示：同时提供 31 页文章教程、最小中文示例和独立 Beamer 示例。
• 不仅展示正确写法：章节包含学习目标、常见错误、彩色提示框与章末检查。
• 持续验证：GitHub Actions 会编译三个入口，确保仓库中的示例保持可用。

本项目面向希望使用中文系统学习 LaTeX 的初学者，尤其适合：

• 第一次接触 LaTeX，希望理解“源码如何变成 PDF”的读者；
• 需要完成课程报告、数学作业或实验报告的学生；
• 希望使用 LaTeX 撰写论文、研究报告或管理参考文献的读者；
• 希望用 Beamer 制作课程演示、学术报告或答辩幻灯片的人。

不要求提前掌握复杂的编程知识。你只需要能够使用 VS Code，并愿意一次修改一个地方，再对照源码和 PDF 观察结果。

安装 TeX Live、MacTeX 或 MiKTeX，并确认终端能够运行 latexmk、xelatex 和 biber。详细步骤见安装与编译。

git clone https://github.com/Tamarisk-Du/latex-tutorial.git
cd latex-tutorial

latexmk -xelatex -synctex=1 -interaction=nonstopmode -file-line-error -outdir=build main.tex

完成后打开 build/main.pdf。如果暂时不想安装环境，可以直接下载最新教程 PDF。

推荐依次学习 01 到 06 章，再通过第 07 章理解多文件结构，最后阅读第 08 章和独立的 beamer-demo.tex。

完整演示可从 Release 页面下载，也可以在本地编译 beamer-demo.tex。

完整的安装、PATH 检查、VS Code 配置和清理命令见 docs/installation.md。遇到缺少命令、宏包、字体、Biber 或 SyncTeX 问题时，先查看 docs/troubleshooting.md。

根文件是一次编译的总入口，负责载入需要的内容并生成自己的 PDF。

sections/ 中的编号章节由 main.tex 统一载入，不应单独编译。章节首行的 % !TEX root = ../main.tex 会帮助 LaTeX Workshop 找到正确入口。

latex-tutorial/
├── .github/
│   └── workflows/
│       └── build.yml                   # 自动编译三个入口
├── .vscode/
│   └── settings.json                   # 跨平台 XeLaTeX/latexmk 配置
├── docs/
│   ├── images/                         # README 真实效果预览
│   ├── installation.md                 # 安装与编译
│   └── troubleshooting.md              # 固定排错顺序
├── figures/
│   ├── example-figure.tex              # 示例图片源码
│   └── example-figure.pdf              # 文章与演示共同使用的图片
├── sections/
│   ├── 01-getting-started.tex
│   ├── 02-document-structure.tex
│   ├── 03-text-formatting.tex
│   ├── 04-tables-and-figures.tex
│   ├── 05-mathematics.tex
│   ├── 06-theorems-and-references.tex
│   ├── 07-large-projects.tex
│   └── 08-beamer.tex
├── main.tex                            # 完整教程入口
├── beamer-demo.tex                     # Beamer 入口
├── example.tex                         # 最小中文示例
├── references.bib                      # 参考文献数据库
├── LICENSE                             # 双许可证范围说明
├── LICENSE-CODE                        # 代码与配置：MIT
└── LICENSE-CONTENT                     # 教程与媒体：CC BY 4.0

build/ 会在本地编译时自动产生，其中包含 PDF、SyncTeX 和辅助文件。它已被 Git 忽略；正式 PDF 通过 GitHub Actions 和 Releases 分发。

1. 先打开 main.tex，找到导言区、正文开始处和八条 \input{...}。
2. 从 sections/01-getting-started.tex 开始，一次只修改一个地方。
3. 保存后对照 build/main.pdf，确认源代码与版面变化的对应关系。
4. 学完文章教程后，单独打开并编译 beamer-demo.tex。
5. 编译失败时先撤回最后一次修改，再按固定排错顺序检查第一条真实错误。

先安装 LaTeX Workshop，再用 VS Code 打开整个项目文件夹。项目会在停止输入约 1 秒后自动保存，并在保存时使用 XeLaTeX recipe 构建当前根文件。

源码与 PDF 双向定位称为 SyncTeX。如果 VS Code 显示受限模式，只应在确认仓库来源可信后信任工作区。

在项目根目录按需要运行：

latexmk -xelatex -synctex=1 -interaction=nonstopmode -file-line-error -outdir=build main.tex
latexmk -xelatex -synctex=1 -interaction=nonstopmode -file-line-error -outdir=build beamer-demo.tex
latexmk -xelatex -synctex=1 -interaction=nonstopmode -file-line-error -outdir=build example.tex

latexmk 会根据需要重复运行 XeLaTeX，并为 main.tex 自动调用 Biber。-outdir=build 统一保存 PDF、日志、SyncTeX 与其他辅助文件。

这些文件都可以重新生成，不应提交到 Git。

1. 在 Problems 面板或对应 .log 中找到第一条真正错误。
2. 根据文件名和行号检查花括号、数学模式，以及 \begin{...} / \end{...}。
3. 检查文件名、相对路径与大小写。
4. 确认编译的是正确根文件。
5. 清理辅助文件后重新完整编译。
6. 仍然失败时，只保留最小修改并再次检查第一条错误。

更详细的逐类处理方法见常见问题与固定排错顺序。

欢迎通过 Issue 或 Pull Request 修正错字、改进跨平台说明、补充可复现的报错案例，或完善现有 LaTeX 示例。提交修改前请至少编译受影响的根文件；涉及共享宏或图片时，建议编译全部三个入口。

• 八章中文 LaTeX 教程与独立 Beamer 示例
• 跨平台 VS Code/latexmk 说明
• GitHub Actions 自动编译
• 可直接下载的版本化 PDF
• 增加经过验证的 Windows/Linux 环境记录
• 补充常见错误的真实截图与最小复现
• 继续改善预览图的可访问性说明

本仓库采用双许可证：

• 编辑器设置、自动化配置、LaTeX 命令与示例代码使用 MIT License。
• README、文档、教程讲解文字、注释、渲染 PDF 与预览图片使用 CC BY 4.0。

完整的适用范围见 LICENSE。对于同时包含源码与讲解文字的 .tex 文件，命令和示例代码适用 MIT，解释性文字与注释适用 CC BY 4.0。