Windows 下 LaTeX 安装与 VSCode 配置攻略（自用版）
为了避免每次重装时到处找攻略，特此记录...
1. 安装 LaTeX 发行版：二选一
主流的发行版有 TeX Live 和 MiKTeX，它们的对比和选择如下：
| 特性 | MiKTeX | TeX Live |
|---|---|---|
| 安装大小 | 较小（初始约 200 MB） | 很大（完整版约 4-6 GB） |
| Perl 包含 | 不包含，需要单独安装 | 已包含精简版 Perl |
| 包管理 | 按需下载安装 | 默认全安装，也可选部分 |
| 推荐用户 | 希望节省空间、网络良好的用户 | 需要离线工作、希望一劳永逸的用户 |
| 配置复杂度 | 需要额外安装 Perl | 安装后基本无需额外配置 |
方案A：安装 MiKTeX（轻量）
优点：体积小，宏包按需下载安装，适合网络环境好的用户。
- 访问 MiKTeX 官网：https://miktex.org/download
- 根据系统位数下载安装程序，基本全程“下一步”。
- 新版会自动配置环境变量，无需手动操作，安装后无需重启。
- 必须额外安装：下载安装 Strawberry Perl（开源免费），因为 MiKTeX 不自带 Perl。
方案B：安装 TeX Live（完整，一劳永逸）
优点：包含几乎所有宏包和工具，适合需要离线工作或不想中途下载包的用户。
- 访问 TeX Live 官网：https://www.tug.org/texlive/
- 下载
install-tl-windows.exe安装程序。 - 安装时可选择“简化安装”（安装全部）或“自定义安装”选择部分内容。
- 重要：TeX Live 自带精简版 Perl，绝大多数情况下不需要再单独安装 Strawberry Perl。
! ! !
- 如果选 MiKTeX → 必须安装 Strawberry Perl
- 如果选 TeX Live → 先不安装 Strawberry Perl，大多数情况下够用。只有遇到特定 Perl 模块错误时再考虑安装。
2. 安装编辑器 VSCode
- 访问 VSCode 官网 下载安装
- 安装过程简单直观，建议为所有用户安装并添加到右键菜单。
3. 配置 VSCode 的 LaTeX 插件
3.1 安装核心插件
在 VSCode 扩展市场中搜索并安装 LaTeX Workshop。这是 VSCode 中编写 LaTeX 的必备插件。
3.2 基本测试
安装完成后，可以尝试：
- 文件 -> 打开文件夹，选择一个包含
.tex文件的文件夹。 - 打开
.tex文件，若代码已高亮显示，说明插件基础功能已激活。
4. 高级配置（优化使用体验）
以下配置旨在模拟 Overleaf 的流畅体验，并实现高效的正向/反向搜索。
4.1 修改 VSCode 设置
打开 VSCode 设置, 点击 "在settings.json中编辑", 见下：
将以下配置复制粘贴到 settings.json 中：
{// ========== LaTeX Workshop 核心配置 ==========// 禁止保存时自动编译，改为手动触发更可控"latex-workshop.latex.autoBuild.run": "never",// 隐藏编译过程中的错误和警告弹窗，保持编辑器安静"latex-workshop.message.error.show": false,"latex-workshop.message.warning.show": false,// 定义编译工具链 (xelatex, pdflatex, bibtex)"latex-workshop.latex.tools": [{"name": "xelatex","command": "xelatex","args": ["-synctex=1", // 生成同步文件，用于双向搜索"-interaction=nonstopmode", // 非交互模式，遇错不暂停"-file-line-error", // 在日志中显示文件名和行号"%DOCFILE%"]},{"name": "pdflatex","command": "pdflatex","args": ["-synctex=1","-interaction=nonstopmode","-file-line-error","%DOCFILE%"]},{"name": "bibtex","command": "bibtex","args": ["%DOCFILE%"]}],// 定义编译配方（可供选择的编译流程）"latex-workshop.latex.recipes": [{"name": "xelatex (单次编译)","tools": ["xelatex"]},{"name": "pdflatex (单次编译)","tools": ["pdflatex"]},{"name": "xe->bib->xe->xe (带参考文献的完整编译)","tools": ["xelatex", "bibtex", "xelatex", "xelatex"]},{"name": "pdf->bib->pdf->pdf (带参考文献的完整编译)","tools": ["pdflatex", "bibtex", "pdflatex", "pdflatex"]}],// ========== PDF 预览器配置 ==========// 使用 VSCode 内置的标签页预览 PDF（推荐，支持双向搜索）"latex-workshop.view.pdf.viewer": "tab",// 定义内置预览器的反向搜索快捷键：按住 Ctrl 键并点击 PDF"latex-workshop.view.pdf.internal.synctex.keybinding": "ctrl-click",// ========== 其他编辑器优化 ==========// 关闭缩略图，节省屏幕空间"editor.minimap.enabled": false,// 确保缩进使用制表符宽度保持一致"editor.indentSize": "tabSize",
}
配置项详解：
autoBuild.run:”never”：关闭保存自动编译，避免频繁编译大文档。message.error/warning.show:false：屏蔽弹窗警告，编译信息在下方“输出”面板查看。view.pdf.viewer:”tab”：在 VSCode 内部标签页打开PDF，tab键浏览pdf。internal.synctex.keybinding:”ctrl-click”：设置反向搜索为Ctrl + 鼠标单击。- 效果：
四个配方和Overleaf保持一致, 相当方便！
![alt text]()
- 实际上，这个就是内置设置, 省去了一个一个去设置里调整。
5. 使用技巧：实现高效双向搜索
5.1 正向搜索（从代码定位到PDF）
将光标放在 .tex 文件的某行代码中，按下快捷键 Alt + Ctrl + J，PDF 预览将自动滚动并高亮对应的编译结果区域。
5.2 反向搜索（从PDF定位到代码）
在 VSCode 内置的 PDF 预览标签页中，按住 Ctrl 键的同时，用鼠标单击 PDF 上的任意位置，编辑器将自动跳转到生成该内容的源代码行。
参考文献与进一步阅读
- 使用VSCode编写LaTeX
- How to install LaTeX (with previews & autocomplete) for VSCode on Windows
- Windows 下 LaTex 超简单地安装使用（MikTeX + VSCode)
- VSCode 内置预览器实现双向搜索
如果在配置过程中遇到问题，可以参考上述参考文献及其评论区😊
