![[科研实践] VS Code (Copilot) + Overleaf：用 Overleaf Workshop 插件打通 LaTeX 写作流](http://pic.xiahunao.cn/yaotu/[科研实践] VS Code (Copilot) + Overleaf：用 Overleaf Workshop 插件打通 LaTeX 写作流)
1. 科研写作的真实痛点为什么要在 VS Code 里写 LaTeX写论文这件事最怕的不是没思路而是工具链割裂。我身边不少做科研的朋友日常状态是这样的Overleaf 网页开着写正文本地 VS Code 开着跑代码和画图公式想用 AI 补全却只能在网页里手动敲改一个符号要等网页编译转圈。Overleaf 自带的 Writefull 润色说实话对中文语境和复杂公式支持一般改出来的句子经常词不达意。于是问题就变成了能不能把 Overleaf 的项目同步到本地 VS Code用 Copilot 补全 LaTeX 公式和段落改完再同步回 Overleaf答案是能靠的就是 Overleaf Workshop 这个插件。它做的事情本质上是把 Overleaf 的项目通过官方 API 拉到本地编辑器里你在 VS Code 里编辑.tex文件保存后触发远程编译PDF 预览直接刷新。适合谁适合已经习惯 VS Code、又想保留 Overleaf 协作和云端编译能力的科研党、研究生、需要写大量公式的工程同学。这篇就按能跟做的标准来先讲清楚插件连接的前置准备再给一份可复制的settings.json骨架然后演示一次本地编辑同步到 Overleaf 的完整验证动作最后把常见的坑列出来。全程不涉及任何网络工具只用 Overleaf 官方账号和 VS Code 插件本身。2. 前置准备Overleaf Workshop 插件与账号连接在动手之前先把几个概念理清楚不然后面配置容易懵。Overleaf Workshop 是 VS Code 市场里的一个插件安装后在左侧活动栏会出现一个专属图标。它的工作模式是你提供 Overleaf 账号的登录凭证插件支持通过 cookie 方式复用已登录会话插件调用 Overleaf 的 API 拉取你的项目列表选中某个项目后它会把项目文件下载到本地一个工作区同时建立与远程的同步通道。这里有个关键点要说明插件连接的是 Overleaf 官方服务走的是账号自身的 API 权限不涉及任何第三方中转。你登录的账号能看到哪些项目插件就能拉到哪些项目权限边界完全一致。安装步骤很直接打开 VS Code进入扩展面板搜索 Overleaf Workshop点击安装。安装完成后左侧栏出现图标点击图标右侧的 号会弹出登录方式选择。插件提供几种登录途径其中 cookie 方式最省事——因为你浏览器里已经登录了 Overleaf直接复用那段会话凭证即可。获取 cookie 的操作在浏览器打开 Overleaf 并确保已登录按 F12 打开开发者工具切到 Network网络面板在筛选框输入/project然后刷新页面。这时会看到一条/project的请求记录点进去找到 Request Headers请求标头里面有一整段cookie:开头的字符串全选复制。回到 VS Code选择通过 cookie 登录粘贴回车。插件就会列出你账号下的所有项目。注意cookie 属于敏感凭证等同于你的登录态。不要把它贴到公开的 issue、聊天群或者截图里。如果怀疑泄露去 Overleaf 账号设置里退出所有会话即可失效。3. 可复制配置settings.json 连接与编译骨架插件装好、账号连上之后真正决定写作流顺不顺的是settings.json里的几项配置。下面这份骨架你可以直接抄进 VS Code 的用户设置或工作区设置里按需改路径和参数。{ overleaf-workshop.cookie: , overleaf-workshop.serverUrl: https://www.overleaf.com, overleaf-workshop.compile.engine: pdflatex, overleaf-workshop.compile.recipe: latexmk, overleaf-workshop.compile.outputDirectory: ./out, overleaf-workshop.compile.autoCompileOnSave: true, overleaf-workshop.compile.timeout: 120000, overleaf-workshop.sync.autoDownloadOnOpen: true, overleaf-workshop.sync.conflictStrategy: ask, latex-workshop.latex.autoBuild.run: never, latex-workshop.latex.outDir: %DIR%/out, files.autoSave: afterDelay, files.autoSaveDelay: 2000 }逐项解释一下避免你抄完不知道在改什么。overleaf-workshop.cookie留空是有意的——建议用插件 UI 登录让插件自己管理凭证不要硬编码在配置文件里否则一旦这个文件被同步到 Git 仓库就麻烦了。serverUrl保持官方地址如果你用的是学校自建的 Overleaf 实例改成对应域名。compile.engine和compile.recipe决定编译方式。pdflatex适合绝大多数不含中文的论文如果你的文档用了xelatex处理中文字体把 engine 改成xelatexrecipe 保持latexmk即可latexmk 会自动处理多次编译和参考文献。outputDirectory指定编译产物目录配合latex-workshop.latex.outDir保持一致避免中间文件散落一地。autoCompileOnSave设成true后你按 CtrlS 就会触发远程编译这是整个流程里最爽的一环。timeout给到 120 秒是因为含大量图片或参考文献的论文编译可能偏慢给足余量。sync.conflictStrategy设成ask当本地和远程同时被改动时插件会问你保留哪边比自动覆盖安全。files.autoSave用afterDelay配合 2 秒延迟避免你每敲一个字就触发一次同步。提示如果你同时装了 LaTeX Workshop 插件记得把它的autoBuild.run设为never否则两个插件会抢着编译出现重复报错。让 Overleaf Workshop 负责远程编译LaTeX Workshop 只负责本地语法高亮和预览即可。4. 验证请求一次本地编辑同步到 Overleaf 的完整动作配置写完得验证它真的通了。下面这套动作我建议你完整走一遍确认每个环节都正常。第一步在 VS Code 里打开 Overleaf Workshop 面板点击项目列表里的目标论文选择在新窗口打开。插件会把项目文件拉到本地工作区左侧出现.tex文件树右侧可以按CtrlAltVmacOS 是CtrlCmdV打开 PDF 预览。第二步找到主文件main.tex在\begin{document}之后随便加一行测试内容比如\section{同步验证} 这是一段用于验证本地编辑同步到 Overleaf 的测试文字。第三步按CtrlS保存。观察 VS Code 右下角状态栏会出现编译进度提示。如果配置正确几秒到几十秒后右侧 PDF 预览会自动刷新新加的 section 出现在文档里。第四步打开浏览器里的 Overleaf 网页版刷新项目页面确认刚才那段文字也出现在了网页端的源码里。这一步是验证本地改动确实推到了远程而不只是本地预览。第五步反向验证在 Overleaf 网页端改一个字保存回到 VS Code用插件面板的同步/拉取功能或重新打开项目确认本地文件也更新了。双向都通说明同步通道完全建立。如果你想让 Copilot 参与进来在.tex文件里敲公式时比如输入\begin{equation}后换行Copilot 会根据上下文给出补全建议按 Tab 接受。写段落时同理它能根据你前面写的句子续写符合学术语气的表达。实测下来公式补全的准确率比段落续写更高因为 LaTeX 语法结构相对固定。\begin{equation} \mathcal{L}(\theta) \frac{1}{N} \sum_{i1}^{N} \left( y_i - f(x_i; \theta) \right)^2 \end{equation}上面这段损失函数你敲到\mathcal{L}之后 Copilot 大概率就能把后面的结构补出来省去查符号的时间。5. 本篇常见错排查连接失败、编译超时与同步冲突配置过程中最容易卡住的几个点我按出现频率排一下。连接失败项目列表为空。九成是 cookie 过期了。Overleaf 的会话有有效期隔几天 cookie 就失效。解决办法是重新去浏览器抓一次 cookie或者干脆在插件里退出登录重新走一遍。另外确认serverUrl没写错多一个斜杠少一个斜杠都可能导致 API 请求 404。编译一直转圈然后超时。先看是不是文档本身编译就慢——去 Overleaf 网页端点一次 Recompile如果网页端也慢那是文档问题不是插件问题。常见原因是图片太大、参考文献条目过多、或者用了需要多次编译的交叉引用。把timeout调大或者精简图片。还有一种情况是 engine 选错了中文文档用pdflatex会直接报字体错误换成xelatex就好。保存后 PDF 不刷新。检查autoCompileOnSave是否为true以及状态栏有没有报错。有时候是编译产物目录out不存在导致写入失败手动建一个空目录即可。另外如果你同时开了 LaTeX Workshop 的自动编译两个进程打架也会导致预览不更新按前面说的把其中一个关掉。同步冲突本地改动被覆盖。这就是conflictStrategy设成ask的意义。冲突通常发生在你本地改了文件、同时网页端也改了同一处。插件会弹窗让你选保留本地还是远程。养成习惯动手前先拉取一次最新版本改完立刻保存同步别让本地和远程长时间分叉。Copilot 在.tex里不触发补全。确认 Copilot 插件本身已登录且在其他语言文件里能正常工作。LaTeX 不在 Copilot 的默认优先语言列表里有时需要你多敲几个字符给它上下文。如果实在不触发检查文件语言模式是不是被识别成了纯文本手动切成 LaTeX。6. 把写作流固定下来日常使用与工具衔接整套流程跑通之后你日常的写作节奏会变成这样早上打开 VS Code插件自动拉取 Overleaf 最新版本你对着 PDF 预览写正文公式交给 Copilot 补全段落让它续写初稿你再润色按 CtrlS 触发远程编译改完关掉。合作者那边在 Overleaf 网页端看到的永远是最新版本协作不受影响。这里要提醒一句Overleaf Workshop 是连接和同步工具它不替代 Overleaf 本身也不替代你的编辑器。它的价值在于把云端协作和本地 AI 补全这两件事缝在了一起。如果你写的是纯英文论文、公式不多其实网页端也够用但一旦涉及大量公式、需要 Copilot 辅助、或者你受不了网页编辑器的响应速度这套组合的收益就非常明显。如果你在配置过程中遇到连接或编译报错可以去 TaoToken 的 API Keys 页面和接入文档对照检查参数文档里有针对不同编译引擎的配置示例。想先验证模型补全效果可以直接在模型对话里试几段 LaTeX 公式生成确认输出质量再决定要不要长期用。对于需要长期跑编码和 Agent 任务的场景Coding Plan 提供了更稳定的额度方案适合把 AI 补全纳入日常科研工作流的同学。工具链这东西搭一次省半年。把 Overleaf Workshop 的连接和编译配置固定进settings.json以后换机器、重装 VS Code复制一份配置就能恢复整套写作流比每次重新摸索省事得多。 [科研实践] VS Code (Copilot) + Overleaf：用 Overleaf Workshop 插件打通 LaTeX 写作流
1. 科研写作的真实痛点为什么要在 VS Code 里写 LaTeX写论文这件事最怕的不是没思路而是工具链割裂。我身边不少做科研的朋友日常状态是这样的Overleaf 网页开着写正文本地 VS Code 开着跑代码和画图公式想用 AI 补全却只能在网页里手动敲改一个符号要等网页编译转圈。Overleaf 自带的 Writefull 润色说实话对中文语境和复杂公式支持一般改出来的句子经常词不达意。于是问题就变成了能不能把 Overleaf 的项目同步到本地 VS Code用 Copilot 补全 LaTeX 公式和段落改完再同步回 Overleaf答案是能靠的就是 Overleaf Workshop 这个插件。它做的事情本质上是把 Overleaf 的项目通过官方 API 拉到本地编辑器里你在 VS Code 里编辑.tex文件保存后触发远程编译PDF 预览直接刷新。适合谁适合已经习惯 VS Code、又想保留 Overleaf 协作和云端编译能力的科研党、研究生、需要写大量公式的工程同学。这篇就按能跟做的标准来先讲清楚插件连接的前置准备再给一份可复制的settings.json骨架然后演示一次本地编辑同步到 Overleaf 的完整验证动作最后把常见的坑列出来。全程不涉及任何网络工具只用 Overleaf 官方账号和 VS Code 插件本身。2. 前置准备Overleaf Workshop 插件与账号连接在动手之前先把几个概念理清楚不然后面配置容易懵。Overleaf Workshop 是 VS Code 市场里的一个插件安装后在左侧活动栏会出现一个专属图标。它的工作模式是你提供 Overleaf 账号的登录凭证插件支持通过 cookie 方式复用已登录会话插件调用 Overleaf 的 API 拉取你的项目列表选中某个项目后它会把项目文件下载到本地一个工作区同时建立与远程的同步通道。这里有个关键点要说明插件连接的是 Overleaf 官方服务走的是账号自身的 API 权限不涉及任何第三方中转。你登录的账号能看到哪些项目插件就能拉到哪些项目权限边界完全一致。安装步骤很直接打开 VS Code进入扩展面板搜索 Overleaf Workshop点击安装。安装完成后左侧栏出现图标点击图标右侧的 号会弹出登录方式选择。插件提供几种登录途径其中 cookie 方式最省事——因为你浏览器里已经登录了 Overleaf直接复用那段会话凭证即可。获取 cookie 的操作在浏览器打开 Overleaf 并确保已登录按 F12 打开开发者工具切到 Network网络面板在筛选框输入/project然后刷新页面。这时会看到一条/project的请求记录点进去找到 Request Headers请求标头里面有一整段cookie:开头的字符串全选复制。回到 VS Code选择通过 cookie 登录粘贴回车。插件就会列出你账号下的所有项目。注意cookie 属于敏感凭证等同于你的登录态。不要把它贴到公开的 issue、聊天群或者截图里。如果怀疑泄露去 Overleaf 账号设置里退出所有会话即可失效。3. 可复制配置settings.json 连接与编译骨架插件装好、账号连上之后真正决定写作流顺不顺的是settings.json里的几项配置。下面这份骨架你可以直接抄进 VS Code 的用户设置或工作区设置里按需改路径和参数。{ overleaf-workshop.cookie: , overleaf-workshop.serverUrl: https://www.overleaf.com, overleaf-workshop.compile.engine: pdflatex, overleaf-workshop.compile.recipe: latexmk, overleaf-workshop.compile.outputDirectory: ./out, overleaf-workshop.compile.autoCompileOnSave: true, overleaf-workshop.compile.timeout: 120000, overleaf-workshop.sync.autoDownloadOnOpen: true, overleaf-workshop.sync.conflictStrategy: ask, latex-workshop.latex.autoBuild.run: never, latex-workshop.latex.outDir: %DIR%/out, files.autoSave: afterDelay, files.autoSaveDelay: 2000 }逐项解释一下避免你抄完不知道在改什么。overleaf-workshop.cookie留空是有意的——建议用插件 UI 登录让插件自己管理凭证不要硬编码在配置文件里否则一旦这个文件被同步到 Git 仓库就麻烦了。serverUrl保持官方地址如果你用的是学校自建的 Overleaf 实例改成对应域名。compile.engine和compile.recipe决定编译方式。pdflatex适合绝大多数不含中文的论文如果你的文档用了xelatex处理中文字体把 engine 改成xelatexrecipe 保持latexmk即可latexmk 会自动处理多次编译和参考文献。outputDirectory指定编译产物目录配合latex-workshop.latex.outDir保持一致避免中间文件散落一地。autoCompileOnSave设成true后你按 CtrlS 就会触发远程编译这是整个流程里最爽的一环。timeout给到 120 秒是因为含大量图片或参考文献的论文编译可能偏慢给足余量。sync.conflictStrategy设成ask当本地和远程同时被改动时插件会问你保留哪边比自动覆盖安全。files.autoSave用afterDelay配合 2 秒延迟避免你每敲一个字就触发一次同步。提示如果你同时装了 LaTeX Workshop 插件记得把它的autoBuild.run设为never否则两个插件会抢着编译出现重复报错。让 Overleaf Workshop 负责远程编译LaTeX Workshop 只负责本地语法高亮和预览即可。4. 验证请求一次本地编辑同步到 Overleaf 的完整动作配置写完得验证它真的通了。下面这套动作我建议你完整走一遍确认每个环节都正常。第一步在 VS Code 里打开 Overleaf Workshop 面板点击项目列表里的目标论文选择在新窗口打开。插件会把项目文件拉到本地工作区左侧出现.tex文件树右侧可以按CtrlAltVmacOS 是CtrlCmdV打开 PDF 预览。第二步找到主文件main.tex在\begin{document}之后随便加一行测试内容比如\section{同步验证} 这是一段用于验证本地编辑同步到 Overleaf 的测试文字。第三步按CtrlS保存。观察 VS Code 右下角状态栏会出现编译进度提示。如果配置正确几秒到几十秒后右侧 PDF 预览会自动刷新新加的 section 出现在文档里。第四步打开浏览器里的 Overleaf 网页版刷新项目页面确认刚才那段文字也出现在了网页端的源码里。这一步是验证本地改动确实推到了远程而不只是本地预览。第五步反向验证在 Overleaf 网页端改一个字保存回到 VS Code用插件面板的同步/拉取功能或重新打开项目确认本地文件也更新了。双向都通说明同步通道完全建立。如果你想让 Copilot 参与进来在.tex文件里敲公式时比如输入\begin{equation}后换行Copilot 会根据上下文给出补全建议按 Tab 接受。写段落时同理它能根据你前面写的句子续写符合学术语气的表达。实测下来公式补全的准确率比段落续写更高因为 LaTeX 语法结构相对固定。\begin{equation} \mathcal{L}(\theta) \frac{1}{N} \sum_{i1}^{N} \left( y_i - f(x_i; \theta) \right)^2 \end{equation}上面这段损失函数你敲到\mathcal{L}之后 Copilot 大概率就能把后面的结构补出来省去查符号的时间。5. 本篇常见错排查连接失败、编译超时与同步冲突配置过程中最容易卡住的几个点我按出现频率排一下。连接失败项目列表为空。九成是 cookie 过期了。Overleaf 的会话有有效期隔几天 cookie 就失效。解决办法是重新去浏览器抓一次 cookie或者干脆在插件里退出登录重新走一遍。另外确认serverUrl没写错多一个斜杠少一个斜杠都可能导致 API 请求 404。编译一直转圈然后超时。先看是不是文档本身编译就慢——去 Overleaf 网页端点一次 Recompile如果网页端也慢那是文档问题不是插件问题。常见原因是图片太大、参考文献条目过多、或者用了需要多次编译的交叉引用。把timeout调大或者精简图片。还有一种情况是 engine 选错了中文文档用pdflatex会直接报字体错误换成xelatex就好。保存后 PDF 不刷新。检查autoCompileOnSave是否为true以及状态栏有没有报错。有时候是编译产物目录out不存在导致写入失败手动建一个空目录即可。另外如果你同时开了 LaTeX Workshop 的自动编译两个进程打架也会导致预览不更新按前面说的把其中一个关掉。同步冲突本地改动被覆盖。这就是conflictStrategy设成ask的意义。冲突通常发生在你本地改了文件、同时网页端也改了同一处。插件会弹窗让你选保留本地还是远程。养成习惯动手前先拉取一次最新版本改完立刻保存同步别让本地和远程长时间分叉。Copilot 在.tex里不触发补全。确认 Copilot 插件本身已登录且在其他语言文件里能正常工作。LaTeX 不在 Copilot 的默认优先语言列表里有时需要你多敲几个字符给它上下文。如果实在不触发检查文件语言模式是不是被识别成了纯文本手动切成 LaTeX。6. 把写作流固定下来日常使用与工具衔接整套流程跑通之后你日常的写作节奏会变成这样早上打开 VS Code插件自动拉取 Overleaf 最新版本你对着 PDF 预览写正文公式交给 Copilot 补全段落让它续写初稿你再润色按 CtrlS 触发远程编译改完关掉。合作者那边在 Overleaf 网页端看到的永远是最新版本协作不受影响。这里要提醒一句Overleaf Workshop 是连接和同步工具它不替代 Overleaf 本身也不替代你的编辑器。它的价值在于把云端协作和本地 AI 补全这两件事缝在了一起。如果你写的是纯英文论文、公式不多其实网页端也够用但一旦涉及大量公式、需要 Copilot 辅助、或者你受不了网页编辑器的响应速度这套组合的收益就非常明显。如果你在配置过程中遇到连接或编译报错可以去 TaoToken 的 API Keys 页面和接入文档对照检查参数文档里有针对不同编译引擎的配置示例。想先验证模型补全效果可以直接在模型对话里试几段 LaTeX 公式生成确认输出质量再决定要不要长期用。对于需要长期跑编码和 Agent 任务的场景Coding Plan 提供了更稳定的额度方案适合把 AI 补全纳入日常科研工作流的同学。工具链这东西搭一次省半年。把 Overleaf Workshop 的连接和编译配置固定进settings.json以后换机器、重装 VS Code复制一份配置就能恢复整套写作流比每次重新摸索省事得多。