VSCode + LaTeX：在VSCode中优雅地编写学术论文_网络技术

在 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 图标。

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，保存后立即生效。