latex 如何在 windows 中安装详细指南:MiKTeX 与 TeX Live 安装教程与初次使用

要在 Windows 中安装 LaTeX,最推荐且最简便的方法是使用一个完整的 LaTeX 发行版。其中,MiKTeX 是广受欢迎且对初学者友好的选择,它提供了所有必要的工具和软件包。您只需从 MiKTeX 官网下载其安装程序,然后按照安装向导的指示完成安装即可。另一种功能强大且跨平台的选择是 TeX Live

LaTeX 是一种高质量的排版系统,尤其适用于创建结构复杂、内容专业的文档,如学术论文、科技报告、书籍以及演示文稿。它以其卓越的排版质量、强大的数学公式处理能力和高度可定制性而广受科研人员、工程师和学生欢迎。本篇文章将详细指导您如何在 Windows 操作系统中安装 LaTeX 环境,让您快速上手。

选择适合您的 LaTeX 发行版

在 Windows 上安装 LaTeX,通常意味着安装一个完整的 LaTeX 发行版。发行版是一个包含了 LaTeX 编译引擎、大量宏包、字体以及相关工具的软件包。目前主流的两个发行版是 MiKTeX 和 TeX Live。

MiKTeX: Windows 用户的推荐选择

  • 优点: 安装过程相对简单,对于 Windows 用户特别优化。拥有“即时安装”功能,当您编译文档时需要某个缺失的宏包,MiKTeX 会自动提示并下载安装。软件体积相对较小,初始下载量不大。
  • 缺点: 主要针对 Windows 平台,更新可能不如 TeX Live 频繁。
  • 适合人群: 初学者、主要在 Windows 上工作且希望安装过程尽量简单的用户。

TeX Live:全面且跨平台的选择

  • 优点: 跨平台(Windows, macOS, Linux),包含几乎所有可用的 LaTeX 宏包和工具,更新频繁,是 LaTeX 社区的“官方”发行版。一旦安装,几乎不会遇到宏包缺失的问题。
  • 缺点: 初始下载和安装文件体积非常大(通常数GB),安装时间较长。
  • 适合人群: 高级用户、需要跨平台兼容性、或者希望一次性安装所有可用宏包的用户。

本教程将分别详细介绍这两种发行版的安装方法。

MiKTeX 在 Windows 中的安装步骤

以下是使用 MiKTeX 在 Windows 中安装 LaTeX 的详细步骤:

  1. 下载 MiKTeX 安装程序

    访问 MiKTeX 官方网站 (https://miktex.org/download)。在下载页面找到适用于 Windows 的 “Net Installer” 或 “Installer” 版本。推荐下载“Installer”版本,它包含了所有核心组件。

    下载完成后,您会得到一个名为 miktex-YY.X-setup.exe(YY.X 是版本号)的文件。

  2. 运行安装程序

    找到下载好的 .exe 文件,右键点击它,选择“以管理员身份运行”。这有助于避免潜在的权限问题。

  3. 同意许可协议

    阅读 MiKTeX 的许可协议,勾选“I accept the MiKTeX copying conditions”(我接受 MiKTeX 的复制条件),然后点击“Next”(下一步)。

  4. 选择安装范围

    您会看到两个选项:

    • Install MiKTeX for anyone who uses this computer:(为使用此计算机的任何人安装 MiKTeX)推荐此选项,它将 LaTeX 环境安装到系统级别,所有用户都可使用。
    • Install MiKTeX only for me:(仅为我安装 MiKTeX)如果您是唯一用户或有特殊需求,可以选择此项。

    选择推荐的选项后,点击“Next”。

  5. 选择安装路径

    默认安装路径通常是 C:\Program Files\MiKTeX。如果您没有特殊需求,保持默认即可。点击“Next”。

  6. 配置首选纸张大小

    在“Preferred paper”下拉菜单中,选择您常用的纸张大小。在中国和欧洲,通常选择 A4;在北美,通常选择 Letter。这个设置可以在以后更改。点击“Next”。

  7. 配置宏包安装方式

    这是 MiKTeX 的一个关键特性。在“Install missing packages on the fly”选项中,建议选择:

    • Ask me first:(先问我)这是最推荐的选项。当您编译文档需要某个缺失的宏包时,MiKTeX 会弹出一个窗口询问是否安装,您可以选择“是”或“否”。
    • Yes:(是)自动安装所有缺失的宏包,不会提示。
    • No:(否)不自动安装宏包,您需要手动安装。

    选择“Ask me first”,然后点击“Next”。

  8. 开始安装

    检查您之前选择的设置摘要。确认无误后,点击“Start”(开始)。安装程序将开始复制文件和配置环境。这个过程可能需要几分钟到十几分钟不等,具体取决于您的电脑性能和网络速度。

  9. 完成安装

    安装完成后,点击“Next”,然后点击“Finish”退出安装向导。

    至此,MiKTeX 已成功安装在您的 Windows 系统中。

TeX Live 在 Windows 中的安装步骤

TeX Live 的安装过程相对 MiKTeX 更为庞大,但一旦安装完成,您将拥有一个非常全面的 LaTeX 环境。

  1. 下载 TeX Live 安装程序

    访问 TeX Live 官方网站 (https://www.tug.org/texlive/acquire-netinstall.html)。找到适用于 Windows 的“install-tl-windows.exe”文件并下载。

    下载完成后,您会得到一个名为 install-tl-windows.exe 的文件。

  2. 运行安装程序

    找到下载好的 .exe 文件,右键点击它,选择“以管理员身份运行”

  3. 启动安装向导

    安装程序启动后,会弹出一个命令行窗口,几秒后会显示图形界面。点击“Install TeX Live”。

  4. 自定义安装(可选但建议查看)

    在安装界面中,您可以点击“Customize”(自定义)来调整一些设置,例如:

    • Scheme: 默认是“full”,包含所有宏包。如果您希望安装更精简的版本,可以选择其他方案。但对于首次安装,推荐保持“full”。
    • Installation directories: 安装路径,默认通常是 C:\texlive\YYYY(YYYY 是年份)。
    • Paper size: 默认纸张大小,同样可选择 A4 或 Letter。
    • Language: 选择您希望安装的语言支持。

    通常情况下,保持默认设置或只修改纸张大小即可。完成自定义后,点击“OK”返回主安装界面。

  5. 开始安装

    在主安装界面,确认您的设置无误后,点击“Install”(安装)。

    请注意: TeX Live 的完整安装包非常大(通常数 GB),下载和安装过程会持续很长时间,可能需要数小时,具体取决于您的网络速度和计算机性能。请耐心等待,确保网络连接稳定。

  6. 完成安装

    当所有文件下载并安装完成后,命令行窗口会提示安装成功。关闭窗口即可。

    至此,TeX Live 已成功安装在您的 Windows 系统中。

验证 LaTeX 安装

无论是安装 MiKTeX 还是 TeX Live,验证安装是否成功都是非常重要的一步。

  1. 打开命令提示符(CMD)

    在 Windows 搜索栏中输入“cmd”或“命令提示符”,然后点击打开。

  2. 输入验证命令

    在命令提示符窗口中,输入以下命令并按回车键:

    latex -v

    或者更常用的是:

    pdflatex -v

    如果您还想验证其他 LaTeX 引擎,可以输入:

    xelatex -v

    lualatex -v

  3. 检查输出结果

    如果 LaTeX 环境安装成功,您将看到类似以下内容的版本信息:

    pdfTeX 3.141592653-2.6-1.40.24 (TeX Live YYYY/W32TeX)
    kpathsea version 6.3.5
    ...

    或者 MiKTeX 的版本信息。只要能显示版本号,就说明 LaTeX 引擎已正确安装并添加到系统路径中。

    如果显示“’pdflatex’ 不是内部或外部命令,也不是可运行的程序或批处理文件。”等错误信息,说明安装可能存在问题,或者环境变量未正确配置。

安装后的第一步:选择 LaTeX 编辑器与编译

LaTeX 本身是一个命令行工具,您需要一个文本编辑器来编写 .tex 源文件,然后使用 LaTeX 编译器将其转换成 PDF 等格式的文档。

常用的 LaTeX 编辑器推荐

虽然任何纯文本编辑器都可以用来编写 LaTeX 代码,但专用的 LaTeX 编辑器或带有 LaTeX 插件的通用编辑器能提供更好的体验,例如语法高亮、自动补全、内置编译功能和 PDF 预览等。

  • TeXstudio

    功能强大、免费开源,内置拼写检查、代码折叠、快速构建、集成 PDF 预览等。对初学者非常友好。

  • TeXworks

    通常随 MiKTeX 或 TeX Live 一起安装,是一个轻量级的编辑器,功能简洁实用,适合快速上手。

  • VS Code (Visual Studio Code) + LaTeX Workshop 插件

    如果您已经在使用 VS Code,安装 LaTeX Workshop 插件可以获得非常出色的 LaTeX 编辑体验,包括自动补全、错误检查、正向/反向搜索、同步预览等。

  • Sublime Text / Atom / Emacs / Vim

    这些通用编辑器通过安装相应的 LaTeX 插件也能提供强大的 LaTeX 编辑功能,但配置可能需要一些额外的步骤。

  • Overleaf (在线 LaTeX 编辑器)

    如果不想在本地安装任何软件,Overleaf 是一个非常优秀的在线 LaTeX 协作平台。它在云端处理编译,您只需一个浏览器即可工作。

编译您的第一个 LaTeX 文档

无论您选择哪个编辑器,基本的编译流程都是相似的。以一个简单的“Hello World”为例:

  1. 创建 .tex 文件

    打开您选择的 LaTeX 编辑器,输入以下代码:

    \documentclass{article}
    \title{我的第一个 LaTeX 文档}
    \author{您的名字}
    \date{\today}
    \begin{document}
    \maketitle
    Hello, LaTeX 世界!这是一个在 Windows 上安装并编译的文档。
    \end{document}

    将此文件保存为 hello.tex(确保文件扩展名为 .tex)。

  2. 编译文档

    在您的 LaTeX 编辑器中,通常会有一个“编译”、“构建”或“Quick Build”按钮(通常是一个绿色的播放或箭头图标),点击它。

    编辑器会调用系统中的 pdflatex(或您选择的其他编译器)命令来处理 hello.tex 文件。如果一切顺利,它将生成一个 hello.pdf 文件。

    如果编辑器没有集成编译功能,您也可以手动在命令提示符中切换到 hello.tex 所在的目录,然后运行:

    pdflatex hello.tex

  3. 查看 PDF 输出

    编译成功后,编辑器通常会自动打开生成的 hello.pdf 文件进行预览。hello.pdf 并双击打开它。

常见问题与故障排除

1. “’pdflatex’ 不是内部或外部命令…”

这通常意味着 LaTeX 编译器的路径没有被正确添加到系统的环境变量中。虽然现代的安装程序通常会自动处理,但如果遇到此问题,您可以尝试:

  • 重新启动计算机。
  • 检查您的系统环境变量 PATH,确保包含 MiKTeX 或 TeX Live 的 bin 目录(例如 C:\Program Files\MiKTeX\miktex\bin\x64C:\texlive\YYYY\bin\windows)。
  • 如果确认路径正确但仍然报错,尝试重新安装,并确保以管理员身份运行安装程序。

2. 缺失宏包 (Missing Packages)

  • MiKTeX 用户: 如果您在安装时选择了“Ask me first”,当编译时遇到缺失宏包,MiKTeX 会弹出一个窗口询问是否安装。点击“是”即可。如果选择了“No”,您需要打开 MiKTeX Console,在“Packages”选项卡中搜索并手动安装。
  • TeX Live 用户: 由于 TeX Live 默认安装所有宏包,通常不会遇到这个问题。如果确实遇到,您可能需要更新 TeX Live,可以在命令提示符中运行 tlmgr update --self --all(可能需要管理员权限)。

3. 安装过程卡住或非常缓慢

  • TeX Live: 完整安装包非常大,下载和安装确实需要很长时间。请确保网络连接稳定,并有足够的磁盘空间。
  • MiKTeX: 如果卡在某个特定文件,可能是下载源有问题。尝试取消安装,然后重新运行。

4. 编译时报错

LaTeX 的错误信息通常比较详细,但对初学者来说可能难以理解。当编译失败时:

  • 仔细阅读错误信息。通常第一条或最后一条错误信息是导致问题的根源。
  • 使用搜索引擎搜索错误信息(将英文错误信息直接复制到 Google 或百度)。通常能找到类似问题的解决方案。
  • 检查您的 .tex 文件是否存在语法错误,例如括号不匹配、命令拼写错误、遗漏了 \end{document} 等。

总结

在 Windows 中安装 LaTeX 是一项相对直接的任务,主要通过选择并安装一个合适的 LaTeX 发行版(MiKTeX 或 TeX Live)来完成。MiKTeX 以其易用性和“即时安装”宏包功能,成为许多 Windows 初学者的首选;而 TeX Live 则以其全面性、跨平台特性和活跃的更新频率,服务于更广泛的用户群体。

安装完成后,您需要选择一个 LaTeX 编辑器来编写文档,并通过内置的或命令行工具进行编译,最终生成高质量的 PDF 文档。掌握了这些基础知识,您就已经迈出了 LaTeX 之旅的第一步,可以开始享受 LaTeX 带来的专业排版体验了!

latex 如何在 windows 中安装