若VSCode中LaTeX无法编译、预览或补全，需安装LaTeX Workshop扩展、配置TeX Live工具链、设置主文档注释、启用Synctex反向同步、正确集成BibTeX及开启数学环境智能补全。
如果您使用 VSCode 编写 LaTeX 学术论文和报告，但无法正常编译、预览或自动补全公式与参考文献，则可能是由于扩展配置缺失或构建链路未正确建立。以下是实现高效 LaTeX 写作的多种配置与操作方法：
本文运行环境：MacBook Air M2，macOS Sequoia。
一、安装核心扩展与工具链
VSCode 本身不支持 LaTeX 编译，需通过扩展桥接本地 TeX 发行版并提供语法支持。必须安装兼容的编辑器扩展与底层编译工具。
1、打开 VSCode 扩展市场（Ctrl+Shift+X 或 Cmd+Shift+X），搜索并安装 LaTeX Workshop 扩展。
2、在系统终端中确认已安装 TeX Live 或 MacTeX；若未安装，访问 tug.org/texlive 下载完整发行版并执行默认安装流程。
3、安装完成后，在 VSCode 设置中搜索 latex-workshop.latex.recipes，确保其值包含 latexmk 或 pdflatex → bibtex → pdflatex ×2 类构建序列。
二、配置主文档与子文件结构
学术论文通常拆分为多个 .tex 文件（如 introduction.tex、methods.tex），需明确指定主文档以启用编译、引用跳转与大纲导航。
1、在项目根目录创建一个顶层文件（例如 main.tex），并在其导言区添加 \documentclass{article} 及必要宏包。
2、在 main.tex 的任意位置（通常在导言区末尾）插入注释行：% !TEX root = main.tex。
3、对所有被 \input{} 或 \include{} 引入的子文件，在首行添加相同注释：% !TEX root = main.tex。
三、启用实时 PDF 预览与反向同步
LaTeX Workshop 支持内嵌 PDF 查看器与光标定位联动，需启用 Synctex 并配置查看器行为以实现双向跳转。
利用 macOS 原生能力实现本地语音识别与合成。通过 yap (Apple Speech.framework) 进行语音转文字，通过 say + ffmpeg 进行文字转语音。完全离线，无需 API 密钥。具备音质检测与智能选声功能。
1、在 VSCode 设置中搜索 latex-workshop.view.pdf.viewer，将其值设为 tab 或 browser。
2、确保编译命令中启用 Synctex：在 latex-workshop.latex.tools 设置中，找到对应工具（如 pdflatex），在其 args 数组内加入 "-synctex=1" 参数。
3、保存后，按 Cmd+Alt+V（macOS）调出 PDF 预览，点击 PDF 中任意位置可自动跳转至对应源码行。
四、管理参考文献与 BibTeX 集成
正确关联 .bib 文件与 \cite 命令依赖于路径声明、编译顺序及 citekey 自动补全支持。
1、将参考文献库保存为 references.bib 并置于项目根目录，或在主文档导言区用 \addbibresource{./refs/references.bib} 显式声明路径。
2、在 VSCode 设置中启用 latex-workshop.intellisense.biblatex.enabled 为 true。
3、编译时选择含 bibtex 或 biber 步骤的 recipe（如 latexmk 默认支持），确保 .aux 文件生成后被正确处理。
五、启用数学环境智能补全与错误高亮
LaTeX Workshop 提供基于正则与语法树的实时校验，需开启 linting 并配置数学模式识别规则以提升公式编写效率。
1、在设置中启用 latex-workshop.linting.enabled 和 latex-workshop.linting.chktex.enabled。
2、在主文档导言区加载 amsmath、mathtools 等常用数学宏包，并确保其路径可被扩展解析。
3、输入 \begin{equation} 后按回车，扩展将自动补全 \end{equation} 并缩进光标；在 $...$ 或 \(...\) 内输入希腊字母缩写（如 alpha）将触发 \alpha 补全。
