正确配置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 对应位置。
