使用 VSCode + LaTeX Workshop 打造高效的 LaTeX 写作环境，告别传统编辑器的繁琐配置。

参考视频

核心优势

• 实时预览：保存时自动编译，PDF 即时更新
• 智能补全：命令、引用、标签一键补全
• 双向跳转：SyncTeX 实现 .tex 与 PDF 精准定位
• 语法检查：LaTeX 错误实时提醒

---

TeX Live 安装

TeX Live 是跨平台的 LaTeX 发行版，包含完整的排版工具链。

Windows

1. 下载安装程序

   TeX Live Windows 安装包

   官方推荐安装方式

2. 运行安装向导

   双击 install-tl-windows.exe，选择安装路径和组件。完整安装约需 7GB 空间，耗时取决于网络速度。

   提示

   点击 Advanced 可自定义安装选项，如仅安装必要宏包以节省空间。

3. 验证安装

   xelatex --version

macOS

1. 下载 MacTeX

   MacTeX 安装包

   macOS 10.14+ 支持 Arm 与 Intel

2. 安装并配置

   双击 .pkg 文件完成安装。MacTeX 会自动配置环境变量。

3. 验证安装

   xelatex --version

---

LaTeX Workshop 配置

安装插件

在 VSCode 扩展商店搜索 LaTeX Workshop 并安装。

推荐配置

打开 VSCode 设置：

• Windows: Ctrl + Shift + P → 输入 Preferences: Open User Settings (JSON)
• macOS: Cmd + Shift + P → 输入 Preferences: Open User Settings (JSON)

添加以下配置（macOS 需指定 latexmk 路径）：

{
  "latex-workshop.latex.autoBuild.run": "onSave",
  "latex-workshop.view.pdf.viewer": "tab",
  "latex-workshop.latexmk.path": "/Library/TeX/texbin/latexmk"
}

提示

macOS 用户可通过 which latexmk 查询实际路径。Windows 通常无需手动配置路径。

---

Git 版本管理

LaTeX 项目天然适合 Git 版本控制：

• 纯文本格式：.tex 文件便于 diff 对比
• 分支管理：轻松维护多个文档版本
• 协作写作：团队成员并行编辑无冲突

推荐 .gitignore

# LaTeX 编译产物
*.aux
*.log
*.out
*.toc
*.synctex.gz
*.fdb_latexmk
*.fls
*.bbl
*.blg

# PDF 输出（可选保留）
# *.pdf

---

参考资料

LaTeX Workshop Wiki

官方完整文档

TeX Live 官网

获取最新 TeX Live 发行版

贡献者: paiad