Windows LaTeX 环境配置和使用

目标是在 Windows 上用 TeX Live 编译中文文档，再接入 VS Code + LaTeX Workshop。完成标志是生成并检查 main.pdf，而不只是看到版本号。

[!info] related notes

• LaTeX：发行版、引擎与编辑器的区别。
• TikZ：安装成功后可使用的绘图宏包。
• Overleaf：不安装本地发行版的另一种工作流。

安装 TeX Live

从 TeX Live Windows 指南 获取安装器，也可使用 清华 CTAN 的 TeX Live ISO 镜像。ISO 可在 Windows 中装载后运行随附的 Windows 安装脚本，具体名称以该版本指南为准。

按所需方案安装引擎、宏包和字体。完整安装体积较大，耗时受版本、网络和磁盘影响，不使用固定的容量或耗时承诺。TeX Live 是一种选择，MiKTeX 是另一种发行版；初次配置不必同时混装。

安装后重新打开终端，检查路径和版本：

where.exe xelatex
xelatex --version
kpsewhich ctex.sty

如果找不到命令，先核对安装目录中的 bin\windows 是否加入 PATH，并重启终端与 VS Code。多个结果应检查优先级，避免调用旧发行版。kpsewhich 无输出表示当前搜索路径找不到该宏包，需检查安装方案。

先用命令行编译

创建 UTF-8 编码的 main.tex：

% !TEX program = xelatex
\documentclass[12pt,a4paper]{ctexart}
\title{我的第一篇 LaTeX 文档}
\author{Baker}
\date{\today}
\begin{document}
\maketitle
\section{引言}
你好，世界！
\subsection{数学公式}
\[E = mc^2\]
\end{document}

在该文件目录运行：

xelatex -interaction=nonstopmode -halt-on-error main.tex

检查进程成功退出、main.pdf 已更新、中文无缺字且公式显示正常。若失败，先看 main.log 的首个错误；缺包应补包，字体错误应检查 ctex 的字体配置。本文选用 XeLaTeX，中文排版并非只能使用这一引擎。

接入 VS Code

安装扩展 LaTeX Workshop（标识 James-Yu.latex-workshop），打开项目文件夹。通过命令面板执行 LaTeX Workshop: Build LaTeX project，再使用其 PDF 查看命令。

% !TEX program = xelatex 是扩展可识别的引擎提示；是否采用受 latex-workshop.latex.build.enableMagicComments 与 recipe 配置影响；旧的 forceRecipeUsage 设置已弃用，旧版本应按对应说明排查。自动构建由 latex-workshop.latex.autoBuild.run 控制，不能假定每次保存都固定调用 XeLaTeX。出现差异时检查扩展输出中实际执行的命令。

如果命令行成功而扩展失败，优先检查 VS Code 是否继承了新 PATH、根文档是否正确、recipe 是否选错。调试时保留 .log；清理辅助文件时不要删除 .tex、图片或 .bib 源文件。

要插入 TikZ 示例，在导言区加入 \usepackage{tikz}。需要参考文献或交叉引用时，可能还需多次编译或使用 latexmk 管理构建。

参考资料

• LaTeX Workshop 编译说明