luong-komorebi/Begin-Latex-in-minutes · 上手攻略

• 仓库：luong-komorebi/Begin-Latex-in-minutes
• 链接：https://github.com/luong-komorebi/Begin-Latex-in-minutes
• 分类：academic-writing
• 作者：Tom
• 更新：2026-08-14

是什么

Begin-Latex-in-minutes 是一个面向零基础新手的 LaTeX 入门教程仓库，通过「跟着例子学」的方式，帮助用户在最短时间内掌握 LaTeX 写论文、报告和书籍的基本操作。仓库以 Markdown 编写，配有大量代码示例和截图，覆盖从安装配置到插入图片、代码、表格、数学公式等常用场景，并提供中文、西班牙语、法语、德语、日语等 9 种语言翻译。

解决什么问题

• 不知道从哪里开始学 LaTeX，找不到简洁的中文入门资料
• 被 LaTeX 的编译错误劝退，不知道如何排查
• 需要写中文/多语言学术文档，不确定 LaTeX 是否支持
• 想快速掌握用 LaTeX 排版数学公式、表格、代码块

快速安装

安装 LaTeX 发行版（二选一）

Windows 推荐 MiKTeX

# 下载地址：https://miktex.org/download
# 安装程序会自动下载所需宏包

macOS 推荐 MacTeX

# 下载地址：https://www.tug.org/mactex/
# 约 5GB，安装后即可使用所有标准 LaTeX 工具

Linux 推荐 TeX Live

# Debian/Ubuntu
sudo apt-get install texlive-full

# Arch Linux
sudo pacman -S texlive-most texlive-lang

安装 LaTeX 编辑器

推荐 TeXMaker（跨平台，界面友好）：

# Windows/macOS/Linux 下载地址：http://www.xm1math.net/texmaker/

其他替代：VS Code + LaTeX Workshop 插件 / Overleaf 在线编辑

在线方案（零安装）

直接使用 Overleaf（免费在线 LaTeX 编辑器），无需安装任何东西，打开浏览器即可写 LaTeX。

核心用法

最小可跑示例（Hello World）

创建文件 hello.tex：

\documentclass[a4paper]{article}

\begin{document}

Hello World!  % 这是你的内容

\end{document}

在 TeXMaker 中按 Quick Build（快速编译），输出 PDF。

LaTeX 文档结构解析

插入数学公式

% 加载数学宏包（通常已默认加载）
\usepackage{amsmath}

% 行内公式
这是一元二次方程 $ax^2 + bx + c = 0$ 的求根公式。

% 独立公式块（居中，带编号）
\begin{equation}
x = \frac{-b \pm \sqrt{b^2-4ac}}{2a}
\end{equation}

插入图片

\usepackage{graphicx}  % 加载图片宏包

\begin{figure}[h!]
  \centering
  \includegraphics[width=\linewidth]{filename.jpg}
  \caption{图片说明}
  \label{fig:myimage}
\end{figure}

[h!] 表示将图片放在当前位置（h=here，!=强制）；也可选 [t]（顶部）、[b]（底部）、[p]（单独浮动页）。

插入代码

% 方法一：verbatim 环境（最简单，适合任意语言）
\begin{verbatim}
#include <iostream>
int main() {
    std::cout << "Hello!" << std::endl;
    return 0;
}
\end{verbatim}

% 方法二：listings 宏包（支持语法高亮）
\usepackage{listings}
\lstset{language=Python}
\begin{lstlisting}
def hello():
    print("Hello, LaTeX!")
\end{lstlisting}

表格

\begin{table}[h!]
  \centering
  \caption{实验结果}
  \label{tab:results}
  \begin{tabular}{l|c||r}
    \hline
    模型 & 准确率 & F1 \\
    \hline
    BERT & 92.3\% & 91.8 \\
    RoBERTa & 93.1\% & 92.7 \\
    \hline
  \end{tabular}
\end{table}

说明：l|c||r 表示三列分别为左对齐、居中、右对齐，| 为垂直分隔线，\hline 为水平线。

多语言支持（中文为例）

方法一：CJK 宏包（适合 pdfLaTeX）

\documentclass[a4paper]{article}
\usepackage{CJKutf8}

\begin{document}
\begin{CJK}{UTF8}{min}
这是一段中文内容。
\section{第一节}
这里是正文。
\end{CJK}
\end{document}

方法二：XeLaTeX / LuaLaTeX + fontspec（推荐现代方案）

\documentclass[a4paper]{article}
\usepackage{fontspec}
\usepackage{polyglossia}
\setmainfont{Noto Sans CJK SC}  % 使用系统安装的中文字体

\begin{document}
这是一段中文内容。
\section{第一节}
这里是正文。
\end{document}

编译时选择 XeLaTeX 或 LuaLaTeX 编译器（TeXMaker 中可配置）。

典型适用场景

• 学术论文写作：理工科投稿、会议论文、学位论文
• 复杂数学文档：含有大量公式的讲义、习题集
• 书籍排版：技术书籍、学位论文、报告
• 多语言文档：需要同时支持中英文的国际化文档
• 代码文档：需要嵌入代码片段并保持语法高亮的教程或笔记

坑与注意

⚠️ 编码问题

旧版 Windows 系统使用 GBK 编码，可能导致中文乱码。建议编辑器统一使用 UTF-8 编码，并在文件头加上 \usepackage[utf8]{inputenc}（pdfLaTeX）或直接使用 XeLaTeX/LuaLaTeX。

⚠️ 编译方式选择

国内用户写中文文档推荐使用 XeLaTeX，无需额外配置编码。

⚠️ 宏包依赖

某些功能（如中文、多语言、数学公式增强）需要额外 \usepackage。首次编译时 MiKTeX 会自动询问并下载缺失宏包；MacTeX / TeX Live 建议安装 texlive-full 避免大多数依赖问题。

⚠️ 调试技巧

LaTeX 报错通常是人类可读的。例如： - Undefined control sequence → 命令拼写错误或宏包未加载 - Missing $ inserted → 数学公式未包裹在 $...$ 中 - File not found → 图片路径错误或文件名含空格

遇到错误不要慌，仔细读报错信息，搜索引擎通常是最佳帮手。

与同类对比

Begin-Latex-in-minutes 的优势在于门槛极低、例子驱动、多语言，适合完全零基础用户快速上手；缺点是深度有限，适合入门但不适合作为工具书。

一句话推荐结论

想 30 分钟入门 LaTeX？直接 clone 这个仓库，对着 README 一个个敲例子，是目前上手门槛最低的多语言 LaTeX 入门资源。