VSCode for LaTeX：学术论文写作的全流程配置_网络技术

正确配置VSCode的LaTeX Workshop扩展、TeX Live工具链、xelatex编译链、CTEX中文支持、BibLaTeX参考文献管理及SyncTeX双向同步，即可实现学术论文的自动编译、中英文混排、文献引用与PDF-源码跳转。

如果您使用 VSCode 编写 LaTeX 学术论文，但无法正确编译、预览或自动补全公式与参考文献，则可能是由于扩展配置缺失或编译链未对齐。以下是完*流程配置的步骤：

本文运行环境：MacBook Air，macOS Sequoia。

一、安装核心扩展与工具链

VSCode 本身不支持 LaTeX 编译，需通过扩展桥接本地 TeX 发行版，并提供语法高亮、错误提示与实时预览能力。

1、打开 VSCode 扩展市场（Ctrl+Shift+X 或 Cmd+Shift+X），搜索并安装 LaTeX Workshop 扩展。

2、在系统终端中确认已安装完整 TeX 发行版：执行 tex --version；若未安装，前往 tug.org/texlive 下载并安装 TeX Live 完整版（非仅 BasicTeX）。

3、验证 LaTeX Workshop 是否识别到编译器：打开任意 .tex 文件后，在左下角状态栏查看是否显示 LaTeX 标识及当前编译器（如 xelatex）。

二、配置默认编译命令与工具链

LaTeX Workshop 默认使用 latexmk，但多数中文论文需指定 xelatex 并启用 shell-escape 权限以支持字体与图形嵌入。

1、按下 Cmd+, 打开设置，搜索 latex-workshop.latex.tools，点击“在 settings.json 中编辑”。

2、在 "tools" 数组中添加新条目：{"name": "xelatex", "command": "xelatex", "args": ["-shell-escape", "-synctex=1", "-interaction=nonstopmode", "-file-line-error", "%DOC%"]}。

3、搜索 latex-workshop.latex.recipe.default，将其值设为 "xelatex"。

三、启用中文支持与字体配置

CTEX 宏包是中文 LaTeX 的标准方案，需在导言区声明并配合系统字体路径调用本地中文字体。

1、在 .tex 主文件导言区加入：\usepackage[UTF8, heading = true, scheme = plain]{ctex}。

2、若使用思源黑体作为正文字体，在导言区添加：\setmainfont{Source Han Sans SC}（macOS 自带该字体）。

3、保存后重新编译，检查 PDF 中汉字是否正常显示且无方框或乱码。

四、集成参考文献管理（BibTeX / BibLaTeX）

BibTeX 是传统方案，BibLaTeX 更灵活且兼容现代宏包；LaTeX Workshop 同时支持两者，需明确指定后端与样式。

1、创建独立的 references.bib 文件，按 BibTeX 格式录入条目（如 @article{...}）。

2、在主文档末尾插入：\bibliographystyle{plainnat} \bibliography{references}（BibTeX 方式）。

3、或改用 BibLaTeX：导言区加载 \usepackage[backend=biber, style=authoryear]{biblatex}，并执行 \addbibresource{references.bib} 与 \printbibliography。

五、配置自动构建与反向同步

避免手动触发编译与定位源码位置，提升写作效率的关键在于自动化工作流与 PDF-源码双向跳转。

1、在 settings.json 中设置 "latex-workshop.latex.autoBuild.run": "onFileChange"，实现保存即编译。

2、确保 PDF 查看器启用 SyncTeX：在 VSCode 中右键 PDF 预览窗口，勾选 Enable SyncTeX。

3、正向同步：PDF 中 Ctrl+Click（macOS）可跳转至对应 .tex 行；反向同步：在 .tex 文件中按 Cmd+Alt+J 触发跳转至 PDF 对应位置。

# vscode # js # json # macbook # 工具 # 后端 # mac # ai # pdf # macos # cos # asic # for # Error # default # 自动化 # 跳转 # 思源 # 发行版 # 运行环境 # 如果您 # 工作流 # 设为 # 右键 # 将其 # 不支持

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】