LaTeX 安装与配置（千字长文）

LaTeX 安装与配置

LaTeX 是一套强大的排版系统，特别适合处理数学公式、科技文档和学术论文。本文将从安装到配置，提供 LaTeX 安装与配置 的完整指南，帮助你在 Windows、macOS 和 Linux 上快速搭建环境并开始使用。

快速解决

直接安装 TeX Live （Linux/macOS 推荐）或 MiKTeX （Windows 推荐），然后使用编辑器如 Overleaf 、TeXstudio 或 VS Code + LaTeX 插件 编写和编译 LaTeX 文档即可。

安装方式选择

### Windows 系统

在 Windows 上，推荐使用 MiKTeX，它提供图形化界面和自动安装缺失包的功能。
前往 MiKTeX 官网 ，下载并运行安装程序。
安装时建议选择“安装所有依赖项”或“按需安装”，以避免后续编译失败。

### macOS 系统

macOS 用户推荐使用 MacTeX，它是 TeX Live 的 macOS 版本。
访问 MacTeX 官网 ，下载 .pkg 安装包并安装。
安装后，LaTeX 工具链会自动添加到系统路径中，可直接在终端中使用 pdflatex、xelatex 等命令。

### Linux 系统

Linux 用户可通过包管理器安装 TeX Live。以 Ubuntu/Debian 为例，执行以下命令：

sudo apt update
sudo apt install texlive-full

该命令会安装完整的 LaTeX 环境，包括常用宏包和工具。若你只需基础功能，可将 texlive-full 替换为 texlive-base。

编辑器推荐与配置

### 使用 TeXstudio

  1. 下载 TeXstudio：
    官网地址
    提供 Windows、macOS、Linux 三个平台的版本。

  2. 安装后打开 TeXstudio，进入 Options -> Configure TeXstudio -> Commands，配置 LaTeX 编译器路径。
    例如，若使用 MiKTeX，路径可能是：C:\Program Files\MiKTeX\texmfc\initexmf\runscript\pdflatex

  3. 保存后，新建 .tex 文件，输入以下内容测试：

    \documentclass{article}
\begin{document}
你好，LaTeX！
\end{document}

  4. 点击编译按钮（默认为 F5），若生成 .pdf 文件，则说明 LaTeX 安装与配置 成功。

### 使用 VS Code + LaTeX Workshop 插件

  1. 安装 VS Code：
    官网地址

  2. 在插件市场中搜索并安装 LaTeX Workshop 插件。

  3. 配置 settings.json 文件，设置默认编译器：

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

    以上配置适用于使用 xelatex 编译器的用户，支持中文排版。

  4. 保存 .tex 文件后，使用快捷键 Ctrl + Alt + T 编译文档。

安装与配置验证

使用以下命令验证 LaTeX 安装与配置 是否完成：

pdflatex --version

若输出包含版本号和编译器信息，表示安装成功。你也可以尝试编译一个简单文档：

\documentclass{article}
\begin{document}
这是一个测试文档。
$$ E = mc^2 $$
\end{document}

将该代码保存为 test.tex，运行：

pdflatex test.tex

如果生成 test.pdf 文件，则说明环境配置正确。

高级配置建议

### 中文支持配置

在 LaTeX 中使用中文，需要配置 xelatex 和中文字体。示例代码如下：

\documentclass{article}
\usepackage{ctex} % 提供中文支持
\begin{document}
你好，世界！这是一个 LaTeX 中文测试文档。
$$ \int_0^\infty e^{-x} dx = 1 $$
\end{document}

ctex 宏包自动处理中文字体和编码，推荐使用 xelatex 编译器。

### 自动编译配置

在 TeXstudio 中，可以配置自动编译：

  1. 打开 Options -> Configure TeXstudio -> Build。
  2. 勾选 Use LaTeXmk，并设置 latexmk -pdf -shell-escape %DOC%。
  3. 启用自动编译后，每次保存 .tex 文件都会自动运行 latexmk。

### 使用图形化界面管理包

MiKTeX 提供了图形化的包管理器（Package Manager），你可以通过它安装缺失的宏包。
路径通常为：MiKTeX Console -> Packages，搜索并安装需要的宏包即可。

常见问题

为什么编译时提示“File not found”？

LaTeX 安装与配置 后，如果编译提示某些宏包缺失，说明未安装这些包。
解决方案：

  • 使用 MiKTeX 的自动安装功能（安装时勾选“按需安装”）
  • 手动通过包管理器安装缺失的宏包
  • 使用 TeX Live 用户可通过 tlmgr install <package> 命令安装

为什么中文显示乱码？

如果你使用 pdflatex 编译器，不支持中文。
解决方案：

  • 切换到 xelatex 编译器
  • 添加 ctex 宏包并设置字体

如何检查 LaTeX 是否安装成功？

运行以下命令查看版本信息：

pdflatex --version
xelatex --version

如果输出版本号，说明安装成功。如果提示“命令未找到”，请检查是否已正确配置环境变量。

总结

LaTeX 安装与配置 是入门排版的第一步，选择合适的发行版和编辑器，合理设置编译器路径和字体，即可高效使用 LaTeX 进行文档编写。