安装LaTeX Workshop扩展并配置xelatex编译链，结合TeX发行版实现VSCode中LaTeX实时预览写作。
要在VSCode中配置LaTeX写作环境并实现实时预览，关键在于安装合适的扩展、配置编译工具链，并设置自动刷新的PDF查看方式。整个过程并不复杂，只要步骤清晰，几分钟内就能搭建好高效的LaTeX写作环境。
安装必要的扩展
打开VSCode，在左侧扩展面板中搜索并安装以下两个核心扩展：
- LaTeX Workshop：这是目前VSCode中最强大、最流行的LaTeX工具扩展，提供编译、错误提示、结构导航和PDF预览功能。
- （可选）LaTeX Utilities：增强语法高亮和命令补全，适合频繁使用自定义命令的用户。
安装LaTeX发行版
VSCode本身不包含LaTeX编译器，需先在系统中安装完整的LaTeX环境：
- Windows：推荐安装 TeX Live 或 MiKTeX，两者都包含编译所需的所有宏包。
- macOS：建议使用 MacTeX，安装后自动配置好路径。
-
Linux：可通过包管理器安装，如Ubuntu执行
sudo apt install texlive-full。
安装完成后，确保能在终端运行 xelatex 或 pdflatex 命令，说明环境已就绪。
配置编译与实时预览
LaTeX Workshop默认支持多种编译链，但为了获得最佳体验，建议手动设置常用编译方式：
- 按下
Ctrl + ,打开设置，搜索“latex workshop latex recipe”，点击“编辑 in settings.json”。 - 添加一个常用的编译流程，例如使用
xelatex → bibtex → xelatex ×2处理含参考文献的文档：
"latex-workshop.latex.recipes": [
{
"name": "xelatex",
"tools": ["xelatex"]
}
],
"latex-workshop.latex.tools": {
"xelatex": {
"command": "xelatex",
"args": [
"-synctex=1",
"-interaction=nonstopmode",
"-file-line-error",
"%DOCFILE%"
]
}
}
保存后，在.tex文件中右键选择“Compile LaTeX document”即可生成PDF。
要实现实时预览：
- 编译成功后，点击VSCode右上角出现的PDF图标，或按
Ctrl + Alt + V打开内置PDF预览。 - 勾选预览窗口中的“SyncTeX”按钮，即可实现PDF与源码的双向跳转（点击PDF跳回对应代码行）。
- 启用自动编译：在设置中搜索“latex auto build”，选择“onFileChange”，保存.tex文件时会自动重新编译。
创建示例文档测试环境
新建一个 test.tex 文件，输入以下内容：
\documentclass{article}
\usepackage{ctex}
\title{测试文档}
\author{作者}
\begin{document}
\maketitle
Hello \LaTeX! 实时预览已就绪。
\end{document}
保存后，自动编译或手动触发编译，PDF预览窗口应立即显示输出结果。修改文字并保存，预览会自动刷新。
基本上就这些。配置一次，长期受益。只要编译器路径正确、扩展安装完整，VSCode配合LaTeX Workshop能提供接近专业编辑器的流畅体验。
