在 VSCode 中高效编写 LaTeX 论文需安装 TeX Live 与 LaTeX Workshop 插件，配置自动编译和内置 PDF 预览，正确设置 BibTeX 参考文献路径，启用大纲导航，并定制代码片段提升效率。
如果您希望在 VSCode 中高效编写 LaTeX 格式的学术论文，但尚未配置合适的插件与工作流，则可能面临编译失败、预览延迟、引用不更新等问题。以下是实现优雅写作的具体操作步骤：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装 LaTeX 发行版与核心插件
VSCode 本身不包含 LaTeX 编译引擎，需依赖本地 TeX 系统，并通过插件桥接编辑与编译流程。LaTeX Workshop 是目前最成熟、功能最完整的 VSCode LaTeX 插件，它支持自动编译、实时预览、引用跳转和错误高亮。
1、访问 https://www.tug.org/texlive/ 下载并安装 TeX Live（macOS 推荐使用全量安装）。
2、打开 VSCode，进入扩展市场，搜索并安装 LaTeX Workshop 插件。
3、重启 VSCode，确保插件已激活，状态栏右下角出现 LaTeX 图标。
二、配置自动编译与 PDF 预览
LaTeX Workshop 默认不启用自动编译，需手动设定构建链与查看器行为，以实现保存即编译、编译即刷新 PDF 的无缝体验。
1、按下 Cmd + Shift + P（macOS）调出命令面板，输入 Preferences: Open Settings (JSON) 并回车。
2、在 settings.json 文件中添加以下配置块：
3、将 "latex-workshop.latex.autoBuild.run": "onFileChange" 设置为启用自动构建。
4、将 "latex-workshop.view.pdf.viewer": "tab" 设为在内置标签页中打开 PDF。
5、保存 settings.json，新建 .tex 文件并输入基础文档结构后，按 Cmd + Alt + B 触发首次编译验证。
三、管理参考文献与交叉引用
BibTeX 或 BibLaTeX 是学术写作中管理参考文献的标准方式，LaTeX Workshop 支持自动解析 .bib 文件并同步生成 .bbl，但需明确指定主文档与参考文献路径，否则引用字段无法解析。
1、在项目根目录创建 references.bib 文件，按 BibTeX 格式录入条目。
2、在主 .tex 文件导言区添加：\bibliographystyle{plain} 和 \bibliography{references}。
3、在 VSCode 中右键点击主 .tex 文件，选择 LaTeX Workshop: Build with recipe，选 latexmk（若未出现，请先安装 latexmk）。
4、编译完成后，检查 PDF 中是否正确显示引用编号与参考文献列表；若显示 ? ?，说明 .bib 路径未被识别，需确认文件名拼写与相对路径。
四、启用结构导航与大纲视图
长篇论文常含多级章节与大量浮动体，手动滚动定位效率低下。LaTeX Workshop 内置的大纲（Outline）功能可解析 \section、\subsection 等命令，生成可点击跳转的层级树。
1、确保主 .tex 文件中所有章节命令均使用标准 LaTeX 语法，如 \section{引言}，而非自定义宏封装。
2、打开 VSCode 左侧活动栏，点击 Outline 图标（或按 Cmd + Shift + O）。
3、大纲视图中将列出所有已解析的章节标题，点击任意条目即可光标跳转至对应位置。
4、如大纲为空，检查文件是否以 .tex 后缀保存，且未被排除在 LaTeX Workshop 监控范围外（如位于 node_modules 目录下）。
五、定制代码片段提升写作效率
重复输入常见 LaTeX 结构（如公式环境、表格框架、定理模板）会打断写作节奏。VSCode 用户代码片段（User Snippets）可一键插入参数化模板，大幅减少机械劳动。
1、按下 Cmd + Shift + P，输入 Preferences: Configure User Snippets，选择 latex.json。
2、在打开的 JSON 文件中添加新片段，例如：
3、键入 eq 后按 Tab，自动展开为带 label 的 equation 环境。
4、为 theorem、proof、tabular 等高频结构分别定义 snippet，保存后立即生效。
