本地实现Overleaf般LaTeX编辑体验
在 Cursor/VS Code 中实现类似 Overleaf 的 LaTeX 编辑体验
前些天发现了一个巨牛的人工智能学习网站,分享一下给大家
目录
- 在 Cursor/VS Code 中实现类似 Overleaf 的 LaTeX 编辑体验
- 1. 安装 TeX 发行版
- 2. 安装 VS Code / Cursor 扩展
- 3. 配置 LaTeX Workshop
- 4. 使用方式
- 5. 效果对比
- 6. 中文支持
要在本地实现类似 Overleaf 的"编辑 → 编译 → 预览 PDF"工作流,你需要以下几个部分:
1. 安装 TeX 发行版
首先需要在系统上安装一个 LaTeX 发行版:
- Windows: 安装 TeX Live 或 MiKTeX
- MiKTeX 更轻量,支持按需下载宏包
- TeX Live 更完整,推荐完整安装
安装后确保pdflatex、xelatex等命令在 PATH 中可用:
# 验证安装pdflatex--version xelatex--version2. 安装 VS Code / Cursor 扩展
安装LaTeX Workshop扩展(作者:James Yu):
- 在扩展市场搜索
LaTeX Workshop并安装 - 这个扩展提供:
- 保存时自动编译
- 内置 PDF 预览(侧边栏显示)
- 正向/反向搜索(点击 PDF 跳转到源码,点击源码跳转到 PDF 位置)
- 语法高亮、自动补全、错误提示
3. 配置 LaTeX Workshop
在settings.json中添加配置:
{// 保存时自动编译"latex-workshop.latex.autoBuild.run":"onSave",// 编译工具链(如果需要中文支持,用 xelatex)"latex-workshop.latex.tools":[{"name":"xelatex","command":"xelatex","args":["-synctex=1","-interaction=nonstopmode","-file-line-error","%DOC%"]},{"name":"pdflatex","command":"pdflatex","args":["-synctex=1","-interaction=nonstopmode","-file-line-error","%DOC%"]},{"name":"bibtex","command":"bibtex","args":["%DOCFILE%"]}],// 编译方案"latex-workshop.latex.recipes":[{"name":"xelatex","tools":["xelatex"]},{"name":"pdflatex","tools":["pdflatex"]},{"name":"xelatex -> bibtex -> xelatex x2","tools":["xelatex","bibtex","xelatex","xelatex"]}],// PDF 预览方式:tab 表示在编辑器内新标签页显示"latex-workshop.view.pdf.viewer":"tab"}4. 使用方式
| 操作 | 方法 |
|---|---|
| 编译 | 保存文件自动触发,或Ctrl+Alt+B |
| 预览 PDF | Ctrl+Alt+V在侧边打开 PDF |
| 正向搜索 | Ctrl+Alt+J(从源码跳到 PDF 对应位置) |
| 反向搜索 | 在 PDF 预览中Ctrl+Click跳回源码 |
| 清理辅助文件 | Ctrl+Alt+C |
5. 效果对比
| 功能 | Overleaf | 本地 (LaTeX Workshop) |
|---|---|---|
| 实时预览 | ✅ | ✅(保存时编译) |
| PDF 内嵌显示 | ✅ | ✅(侧边标签页) |
| 正反向搜索 | ✅ | ✅ |
| 自动补全 | ✅ | ✅ |
| 多人协作 | ✅ | ❌(需要 Git) |
| 离线使用 | ❌ | ✅ |
| 编译速度 | 较慢 | 快(本地资源) |
6. 中文支持
如果写中文文档,推荐使用xelatex+ctex宏包:
\documentclass[UTF8]{ctexart} \begin{document} 你好,世界! \end{document}确保在 recipes 中将xelatex设为第一个(默认使用)。
总结:安装 TeX Live/MiKTeX + LaTeX Workshop 扩展,就能在 Cursor 中获得接近 Overleaf 的体验——左边写代码,右边实时显示 PDF,保存即编译。
