1. 为什么我要在本地复刻 Overleaf写论文、写技术报告、写简历LaTeX 几乎是绕不开的工具。Overleaf 的好处是打开浏览器就能写编译、预览、报错都在一个页面里完成团队协作也方便。但它有两个我始终绕不过去的坎一是网络波动时编译排队二是当我想让 AI 帮我改一段公式或者补一段参考文献格式时得把内容复制到另一个 AI 工具里改完再粘回来来回切换非常割裂。后来我把整套流程搬到了本地用 VS Code 和 Cursor 配合 LaTeX Workshop 扩展基本复刻了 Overleaf 的「左边写、右边预览、保存即编译」体验。更关键的是我把 AI 辅助这一环也接进来了——通过 TaoToken 的统一 Key 和 API 通道VS Code、Cursor 里的 AI 插件、以及我自己写的脚本可以共用同一个入口不用再为每个工具单独配一套 Key。这篇文章面向的是这样一类人已经在本地装了 TeX 发行版或者正准备装希望用 VS Code / Cursor 替代 Overleaf 的在线编辑同时想让 AI 辅助写作这件事变得顺手而不是每换一个工具就重新折腾一遍配置。下面我会给出完整的 settings.json 骨架、TaoToken 的接入方式、编译验证动作以及我实际踩过的几个报错。2. TaoToken 前置统一 Key 与 API 通道在讲 LaTeX Workshop 配置之前先把 AI 这一侧的前置说清楚。因为很多人卡住的地方不是 LaTeX 本身而是「我到底该把 Key 填到哪个插件里」。TaoToken 在这里扮演的角色是一个统一的 API 入口。你可以在它的控制台里创建 API Key然后这个 Key 可以同时被 VS Code 的 AI 插件、Cursor 的自定义模型配置、以及命令行脚本调用。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基础地址是 https://taotoken.net/api 这个不加 UTM。具体操作上你需要先拿到 Key。进入控制台创建 API Key 的入口在这里https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。创建时建议按用途命名比如latex-vscode、cursor-agent这样后面排查哪个 Key 用超了会清楚很多。注意API Key 只显示一次创建后立刻复制保存到本地密码管理器或环境变量里不要直接写进会提交到 Git 的 settings.json。如果你只是想先验证模型能不能通可以用模型对话页面直接试https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。如果打算长期在 Cursor 里跑编码类 Agent 任务可以看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 配置字段对不上时以文档为准。拿到 Key 之后我建议把它写进系统环境变量而不是硬编码。Linux / macOS 可以在~/.zshrc或~/.bashrc里加export TAOTOKEN_API_KEYsk-你的key export TAOTOKEN_BASE_URLhttps://taotoken.net/apiWindows 则在「系统属性 → 环境变量」里新建用户变量变量名TAOTOKEN_API_KEY值填你的 Key。这样 VS Code、Cursor、终端脚本都能读到同一个值真正做到「一次配置多处复用」。3. 可复制配置LaTeX Workshop 的 settings.json 骨架这一节是全文的核心。LaTeX Workshop 的配置项很多但真正影响「Overleaf 式体验」的其实就那么几组编译工具链、编译方案、自动编译触发、PDF 预览方式、正反向搜索。下面这份 settings.json 是我在 VS Code 和 Cursor 里都在用的骨架你可以直接复制后按需改。{ latex-workshop.latex.autoBuild.run: onSave, latex-workshop.latex.tools: [ { name: xelatex, command: xelatex, args: [ -synctex1, -interactionnonstopmode, -file-line-error, %DOC% ], env: {} }, { name: pdflatex, command: pdflatex, args: [ -synctex1, -interactionnonstopmode, -file-line-error, %DOC% ], env: {} }, { name: bibtex, command: bibtex, args: [%DOCFILE%], env: {} } ], latex-workshop.latex.recipes: [ { name: xelatex, tools: [xelatex] }, { name: pdflatex, tools: [pdflatex] }, { name: xelatex - bibtex - xelatex x2, tools: [xelatex, bibtex, xelatex, xelatex] } ], latex-workshop.latex.recipe.default: first, latex-workshop.view.pdf.viewer: tab, latex-workshop.latex.autoClean.run: onBuilt, latex-workshop.latex.clean.fileTypes: [ *.aux, *.bbl, *.blg, *.idx, *.ind, *.lof, *.lot, *.out, *.toc, *.acn, *.acr, *.alg, *.glg, *.glo, *.gls, *.fls, *.log, *.snm, *.nav, *.vrb, *.spl ], latex-workshop.latex.outDir: %DIR%/build, latex-workshop.synctex.afterBuild.enabled: true, latex-workshop.view.pdf.internal.synctex.keybinding: double-click }几个关键点解释一下。autoBuild.run设为onSave就是保存即编译这是 Overleaf 体验的核心。recipe.default设为first意味着默认用 recipes 列表里的第一个方案所以如果你写中文文档把xelatex方案放在第一位就行。outDir设为%DIR%/build把编译产物集中到一个子目录源码目录会干净很多这个习惯我强烈建议保留。view.pdf.viewer设为tabPDF 会在编辑器内新标签页打开而不是弹到外部阅读器这样左右分屏时体验最接近 Overleaf。synctex.afterBuild.enabled打开后正向搜索源码跳 PDF和反向搜索PDF 跳源码才能正常工作。如果你用的是 Cursorsettings.json 的位置和 VS Code 一致CtrlShiftP打开命令面板输入Preferences: Open User Settings (JSON)即可。Cursor 基于 VS Code 内核LaTeX Workshop 扩展可以直接从扩展市场安装配置项完全通用。至于 AI 辅助那一侧如果你用的是支持自定义 API 的插件把 Base URL 填https://taotoken.net/apiKey 填环境变量里的值即可。Cursor 里则是在 Settings → Models 里配置自定义 OpenAI 兼容端点同样填这个 Base URL。这样 LaTeX 编译走本地 TeX 发行版AI 请求走 TaoToken 统一通道两条链路互不干扰。4. 验证请求与成功结果配置写完得验证它真的能跑。我一般分三步先验证 TeX 命令本身可用再验证 LaTeX Workshop 能编译最后验证 AI 通道能通。第一步在终端里确认 TeX 发行版在 PATH 里pdflatex --version xelatex --version bibtex --version三条命令都能输出版本号说明 TeX 环境没问题。如果提示 command not found那就是安装时没勾选「加入 PATH」Windows 下重装 MiKTeX 时注意勾选或者手动把C:\texlive\2024\bin\windows这类路径加进环境变量。第二步新建一个最小测试文件test.tex\documentclass[UTF8]{ctexart} \begin{document} 你好世界 这是一个公式$E mc^2$ \end{document}保存后LaTeX Workshop 应该自动触发编译。左下角状态栏会显示编译进度成功后右侧 PDF 标签页会渲染出「你好世界」和公式。如果没自动编译按CtrlAltB手动触发一次。PDF 出来后在源码里把光标放到「世界」两个字上按CtrlAltJPDF 应该跳到对应位置这就是正向搜索生效的标志。第三步验证 TaoToken 通道。用 curl 发一个最小请求curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: gpt-4o-mini, messages: [{role: user, content: 用一句话解释什么是LaTeX}] }返回里能看到choices字段和一段中文回复就说明 Key 和通道都正常。模型名以你控制台里实际可用的为准接入文档里有完整列表。5. 本篇常见错排查这一节列的都是我自己或身边朋友真实遇到过的报错按出现频率排序。报错一LaTeX Error: File ctexart.cls not found。这是中文宏包没装。MiKTeX 会在编译时弹窗提示按需安装点安装即可TeX Live 用户如果装的是最小化版本需要手动tlmgr install ctex。装完重新编译。报错二编译成功但 PDF 不更新。大概率是outDir设了build目录但 PDF 预览还指向旧路径。解决办法是在 settings.json 里确认latex-workshop.latex.outDir和预览路径一致或者干脆先注释掉 outDir 这一行让产物生成在源码同级目录排除路径干扰后再加回来。报错三正向搜索跳转位置偏移。这通常是-synctex1参数没加或者 PDF 预览用的不是内置 viewer。检查 tools 里每个命令的 args 是否都带了-synctex1以及view.pdf.viewer是否为tab。报错四保存后编译卡住不动。常见于-interactionnonstopmode缺失导致 LaTeX 遇到错误时等待用户输入。确认 args 里有这个参数。另外如果文档里有\write18之类需要 shell 逃逸的命令还要加-shell-escape。报错五AI 插件报 401 或 403。先确认环境变量是否真的被读取——在终端里echo $TAOTOKEN_API_KEY看有没有值。VS Code 从图形界面启动时可能读不到 shell 里 export 的变量这种情况要么重启 VS Code要么在 settings.json 里用插件支持的${env:TAOTOKEN_API_KEY}语法引用。如果还不行去控制台确认 Key 没过期、额度没用完。报错六bibtex 编译后参考文献不显示。这是编译次数不够。bibtex 生成.bbl后需要再跑两次 xelatex 才能把引用编号和文献列表正确写入。用 recipes 里的xelatex - bibtex - xelatex x2方案就能解决别只跑单次 xelatex。6. 把 AI 辅助接进 LaTeX 工作流LaTeX 编译链路跑通之后AI 辅助这一环才是真正拉开效率差距的地方。我的用法是在 Cursor 里选中一段 LaTeX 源码让 AI 帮我改公式、补表格、调格式或者把一段中文描述丢给它让它生成对应的tabular或equation环境。这些请求全部走 TaoToken 的统一通道不用在多个工具之间切换 Key。如果你主要在 VS Code 里写可以装一个支持自定义 API 的对话插件Base URL 填https://taotoken.net/apiKey 用环境变量注入。如果你更习惯 Cursor 的 Agent 模式那就在 Cursor 的模型设置里配同一个 Base URL这样 Cursor 的补全、对话、Agent 任务都走同一条通道。长期跑编码类或写作类 Agent 任务的话Coding Plan 的额度模型会比按次调用更划算具体可以看 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。有一个细节值得单独说LaTeX 源码里%是注释符\是命令前缀把整段源码丢给 AI 时最好用代码块包起来并在提示里说明「这是 LaTeX 源码请保持命令和注释符不变」。否则 AI 有时会「好心」帮你把%删掉导致整段内容被编译进去。这个坑我踩过一次排查了半天才发现是注释符被吃了。最后给一个我常用的提示模板你可以直接拿去用下面是一段 LaTeX 源码请帮我完成以下任务 1. 把 equation 环境里的公式改成 align 环境并对齐等号 2. 保持所有 \label 和 \ref 不变 3. 不要修改任何 % 开头的注释行 源码 latex 粘贴你的源码配置这件事一次做对后面就是纯享受。TeX 发行版 LaTeX Workshop TaoToken 统一 Key这三样凑齐本地就能得到一个比 Overleaf 更可控、AI 辅助更顺手的写作环境。