在 Cursor/VS Code 中实现类似 Overleaf 的 LaTeX 编辑体验


前些天发现了一个巨牛的人工智能学习网站,分享一下给大家


要在本地实现类似 Overleaf 的"编辑 → 编译 → 预览 PDF"工作流,你需要以下几个部分:
在这里插入图片描述

1. 安装 TeX 发行版

首先需要在系统上安装一个 LaTeX 发行版:

  • Windows: 安装 TeX LiveMiKTeX
    • MiKTeX 更轻量,支持按需下载宏包
    • TeX Live 更完整,推荐完整安装

安装后确保 pdflatexxelatex 等命令在 PATH 中可用:

# 验证安装
pdflatex --version
xelatex --version

2. 安装 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,保存即编译。

Logo

中国智能体开发者社区,聚焦智能体与大模型开发,提供前沿资讯、实用工具链、开源项目及行业案例。通过技术沙龙、开发者大赛等活动,促进经验交流与协作,助力开发者快速构建创新智能应用。

更多推荐