答案是安装LaTeX Workshop并配置编译链。需先安装TeX发行版,再在VSCode中安装LaTeX Workshop等扩展,配置xelatex或pdflatex+bibtex编译流程,设置自动编译与PDF预览,确保路径正确并使用ctex支持中文,即可实现高效学术写作。

要在 VSCode 中配置 LaTeX 写作环境,核心是安装合适的扩展并正确设置编译链。重点在于使用 LaTeX Workshop 插件,并配置好编译工具与查看器,实现一键编写、编译和预览。
安装必要组件
开始前需确保系统已安装 TeX 发行版,Windows 用户推荐 MiKTeX 或 TeX Live,macOS 用户可用 MacTeX,Linux 用户可通过包管理器安装 texlive-full。之后在 VSCode 扩展市场中搜索并安装:
- LaTeX Workshop(必备,提供完整 LaTeX 支持)
- 可选:LaTeX Utilities 和 Bookmarks 提升写作效率
配置编译工具链
打开 VSCode 设置(Ctrl + ,),进入设置界面后搜索 "latex workshop latex recipe",点击“编辑 settings.json”手动配置编译流程。常用配置如下:
"latex-workshop.latex.recipes": [
{
"name": "xelatex",
"tools": ["xelatex"]
},
{
"name": "pdflatex -> bibtex -> pdflatex*2",
"tools": ["pdflatex", "bibtex", "pdflatex", "pdflatex"]
}
],
"latex-workshop.latex.tools": {
"xelatex": {
"command": "xelatex",
"args": [
"-synctex=1",
"-interaction=nonstopmode",
"-file-line-error",
"%DOCFILE%"
]
},
"pdflatex": {
"command": "pdflatex",
"args": [
"-synctex=1",
"-interaction=nonstopmode",
"-file-line-error",
"%DOCFILE%"
]
},
"bibtex": {
"command": "bibtex",
"args": ["%DOCFILE%"]
}
}
此配置支持中文排版(xelatex)及参考文献处理(pdflatex + bibtex 流程)。
设置自动编译与PDF预览
启用保存后自动编译和反向同步功能,提升写作体验:
- 开启自动编译:在设置中搜索 "latex auto build",选择 "onFileChange"
- 默认编译命令:设置 "latex-workshop.latex.recipe.default" 为 "first" 或指定常用 recipe
- PDF 查看器内嵌:编译后按 Ctrl+Alt+V 可在右侧打开预览,支持 SyncTeX 反向搜索(从 PDF 跳转到源码)
实用技巧与常见问题
提高使用效率的小建议:
- 使用 %.tex 模板快速新建文档
- 右键选择 “Build with Recipe” 切换不同编译流程
- 若出现找不到命令错误,检查系统 PATH 是否包含 TeX 的 bin 目录
- 中文乱码?确认使用 xelatex 编译,并在导言区加载 ctex 宏包
基本上就这些。配置完成后,VSCode 就能高效支持学术写作,编译日志清晰,报错定位准确,适合撰写论文、报告或书籍。不复杂但容易忽略细节,关键是路径和编译链匹配。










