必须开启VS Code的“Files: Auto Save”并设为afterDelay(1000ms),同时将latex-workshop.latex.autoBuild.run设为onSave,禁用autoBuild.onFileChange,否则自动编译不触发且易致卡顿。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

LaTeX实时编辑过程中,文档内容稍作修改就可能因意外关闭或断电丢失,必须依靠可靠的自动保存机制来保障写作连续性。
确认LaTeX Workshop插件已启用自动保存
打开VS Code → 左下角齿轮图标 → “设置” → 搜索“Files: Auto Save” → 选择“afterDelay”模式。
在下方“Files: Auto Save Delay”输入框中填入【1000】(单位毫秒,即1秒延迟),避免过短间隔引发频繁I/O干扰编译流程。
这一步不做,后续所有自动编译都将失效——因为LaTeX Workshop只对已保存的文件触发构建,未保存的脏文件它直接忽略。
开启自动编译联动保存
仍在设置界面 → 搜索“latex-workshop.latex.autoBuild.run” → 将其值设为“onSave”。
方法一:点击右侧铅笔图标 → 从下拉菜单中选择“onSave”
方法二:直接在settings.json中添加这一行:
"latex-workshop.latex.autoBuild.run": "onSave"
【必须确保“Files: Auto Save”已启用,否则“onSave”不会触发任何编译】
检查并禁用冲突的自动构建行为
搜索“latex-workshop.latex.autoBuild.onFileChange” → 确认该选项为“false”。
如果此项为true,哪怕你只是把光标移到某一行,插件也会尝试编译——极易导致PDF预览卡死、CPU飙高甚至VS Code无响应。
这步常被忽略,但它是防卡顿的关键:onFileChange监听的是文件系统级变更,而onSave监听的是编辑器级保存事件,后者更可控、更稳定。
验证自动保存是否生效
步骤一:新建一个空白.tex文件,输入\documentclass{article}\begin{document}test\end{document}
步骤二:不按Ctrl+S,等待1秒以上 → 观察左下角状态栏是否出现“已保存”提示(非灰色文字)
步骤三:立即查看同目录下是否生成了对应的.pdf文件(若已配置xelatex配方且自动编译开启)
若第2步未出现“已保存”,说明auto save delay未生效;若第3步PDF未更新,说明autoBuild.run未正确绑定到onSave事件。


















