VSCode需通过LaTeX Workshop插件协同本地TeX发行版和BibTeX工具链构建学术写作环境：启用bibfile配置、自定义含biber的recipe、禁用LaTeX自动格式化，并依赖Zotero等外部工具管理文献。
VSCode 本身不原生支持 LaTeX 编译或 BibTeX 引文管理，但通过插件组合可构建接近 Overleaf 的本地学术写作环境——关键不在“单个插件”，而在 LaTeX Workshop + BibTeX 工具链 + 合理配置的协同闭环。
LaTeX Workshop 是唯一值得装的核心插件
它不是“辅助”，而是整个 LaTeX 工作流的调度中心：编译（xelatex/lualatex）、反向搜索、实时预览、错误跳转、结构大纲全部集成。其他所谓“LaTeX 插件”基本是它的功能子集或已废弃。
- 必须配合本地 TeX 发行版（如
TeX Live或MiKTeX），仅装插件无法编译 - 默认不启用 BibTeX 支持，需手动在
settings.json中开启："latex-workshop.latex.bibfile"指向你的.bib文件 - 编译命令需显式包含
bibtex或biber步骤，推荐使用recipe自定义流程，例如：["xelatex", "biber", "xelatex", "xelatex"] - 引用提示（
\cite{...}补全）依赖.bib文件被正确加载且字段完整（author,title,year缺一不可）
BibTeX 文件管理靠外部工具，不是插件功能
LaTeX Workshop 不提供文献库编辑能力。你实际需要的是：
- 桌面端：Zotero +
Zotero Better BibTeX插件（自动生成并同步.bib，支持 CSL 样式导出） - 命令行：用
biber --tool去重/标准化字段（避免Author和author混用导致引用失败） - VSCode 内：仅靠
LaTeX Workshop的Ctrl+Space补全，前提是.bib已被识别且无语法错误（比如缺失右括号、字段值未加花括号）
常见报错 Package natbib Error: Bibliography not initialized 多数因 .bib 路径错、文件名含空格、或 recipe 里漏了 biber 步骤。
数学公式与交叉引用要关掉自动格式化
很多用户装了 Prettier 或 Beautify 后发现公式被错误换行、\label{fig:1} 被删掉——因为这些插件把 LaTeX 当普通文本处理。
- 必须在
settings.json中禁用 LaTeX 文件的自动格式化："[latex]": { "editor.formatOnSave": false } - 交叉引用（
\ref{sec:intro}）依赖两次编译才能生成编号，VSCode 不会自动触发第二次；需手动按Ctrl+Alt+B（或设为保存后自动运行 recipe） - 公式内换行（
align*）若被格式化插件强行折行，会导致编译失败，错误信息通常是! Extra }, or forgotten \endgroup
真正卡住人的从来不是插件装没装，而是 .bib 字段是否规范、recipe 是否包含 biber、以及有没有意识到 LaTeX 的两遍编译机制不能被 IDE 自动绕过。
