必须将默认编译快捷键Ctrl+Alt+B改为Ctrl+Shift+L以避免中文输入法误触和系统冲突;需启用latex-workshop.intellisense.package.enabled支持命令补全;编译参数必须含-synctex=1并配置PDF为tab模式以实现Ctrl+Click双向跳转。

LaTeX Workshop 编译快捷键必须改掉默认的 Ctrl+Alt+B
默认快捷键 Ctrl+Alt+B 在中文输入法下极易误触(比如想打“吧”却触发编译),而且和 Windows 系统级快捷键冲突概率高。直接覆盖为更安全、更符合论文写作节奏的组合。
- 推荐设为
Ctrl+Shift+L:左手操作稳定,远离常用输入法切换键位(Ctrl+Shift是 Win 默认中英切换,但加L后无冲突) - 在 VS Code 中按
Ctrl+K Ctrl+S打开快捷键面板,搜索latex-workshop.build,点击铅笔图标,输入新组合并回车 - 如果用了
latexmk工具链,确保对应命令是latex-workshop.build.withRecipe,而不是单步xelatex—— 否则参考文献和交叉引用会漏刷
数学公式与命令补全要靠 latex-workshop.intellisense.package.enabled
很多用户开了 LaTeX Workshop 却没看到 \frac、\int 等命令提示,不是插件坏了,而是没启用宏包感知。这个开关默认是 false,必须手动打开,否则哪怕你写了 \usepackage{amsmath},VS Code 也不知道该给你推什么命令。
- 打开
settings.json,确认包含这一行:"latex-workshop.intellisense.package.enabled": true - 它依赖
.tex文件里真实的\usepackage{...}声明,不是靠猜测——所以别省略\usepackage{mathtools}或\usepackage{physics}这类扩展包 - 补全触发时机是输入反斜杠后按
Ctrl+Space,不是自动弹出;如果没反应,先检查光标是否在正文区(而非注释或 verbatim 环境内)
PDF 预览跳转用 Ctrl+Click 比菜单更快,但得配对启用 -synctex=1
正向跳转(代码 → PDF)和反向跳转(PDF → 代码)是写论文时最常做的两件事。VS Code 内置 PDF 查看器支持 Ctrl+Click 实现双向定位,但前提是编译参数里带了 -synctex=1,否则点不动。
- 检查你的
latex-workshop.latex.tools配置中每个xelatex或pdflatex的args数组,必须包含"-synctex=1" - PDF 必须在 VS Code 标签页里打开(即
"latex-workshop.view.pdf.viewer": "tab"),外部 PDF 阅读器不支持该功能 - 反向跳转时,PDF 页面需处于焦点状态(点击一下 PDF 区域),再
Ctrl+Click才生效;若跳转位置偏移,大概率是中间文件(.synctex.gz)被自动清理了——关掉latex-workshop.latex.autoClean.run或设为"onBuilt"而非"onFailed"
插入参考文献条目别手敲,用 Ctrl+Alt+Z 触发 BibTeX 补全
手动输 \cite{xxx} 不仅慢,还容易拼错 key。LaTeX Workshop 提供了基于 .bib 文件的实时补全,但默认没绑定快捷键,需要自己配。
- 在
keybindings.json里加这条:{"key":"ctrl+alt+z","command":"latex-workshop.cite","when":"editorTextFocus && editorLangId == 'latex'"} - 触发前确保光标在
\cite{}的花括号内,且项目根目录下有有效的.bib文件(路径需在latex-workshop.bibtex-formatting.enabled开启时被识别) - 补全列表按 BibTeX key 字母序排列,不按作者或年份;如果列表为空,先运行一次
bibtex工具(或选 recipe 中含bibtex的那个),让插件解析出条目


















