如何使用vscode编写LaTeX文档并编译输出【教程】

VS Code 通过 LaTeX Workshop 插件配合本地 TeX 发行版（如 MiKTeX 或 TeX Live）实现完整 LaTeX 编辑编译功能，关键在于插件、latexmk 工具与系统 PATH 的正确配置。 VS Code 本身不内置 LaTeX 编译能力，但通过插件 + 本地 TeX 发行版（如 TeX Live 或 MiKTeX）可以完整替代传统编辑器。关键不是“能不能”，而是 、 和 三者是否对齐。 安装并配置 LaTeX Workshop 插件 这是 VS Code 中最成熟、维护最活跃的 LaTeX 扩展。它不自带编译器，只负责调用、监听、跳转和预览。 在 VS Code 扩展市场搜索 ，安装并重启 确保已安装本地 TeX 环境（Windows 推荐 ， mac OS/Linux 推荐 ），且其二进制目录（如 或 ）已加入系统 打开任意 文件后，状态栏右下角应显示 ，点击可查看当前工具链配置 确认 latexmk 是否可用且版本兼容 是 LaTeX Workshop 默认推荐的自动化构建工具，能自动判断需运行 、 、 多少次。若缺失或版本过旧（ 终端中运行 ，输出应类似 若报错 ，说明 未生效：重启 VS Code（不是仅重载窗口），或手动在 VS Code 设置中指定路径： → 添加 条目并填入绝对路径 Mac 用户常见问题： 安装的是 Perl 版本，但依赖系统 Perl；若用 或 管理环境，可能找不到 ，此时建议改用 （通过 TeX Live 安装） 编写时触发编译的几种方式及对应行为 VS Code 不自动编译，需主动触发。不同操作对应不同底层命令，影响参考文献、交叉引用、目录等是否更新。 Trae win Trae Windows 官方版本现已全面支持 Win10 和 Win11 系统（64位）。国内开发者可直接访问 Trae 中文官网（trae.cn 或 trae.com.cn），一键下载官方正版 .exe 安装包，享受国内直连的高速稳定体验。安装过程极其简便，双击即可运行，并支持一键无缝导入 VS Code 或 Cursor 的原有主题、快捷键及插件配置。登录支持手机号、微信或稀土掘金账号。内置免费的豆包与 DeepSeek 等顶级大模型，让你开箱即用，轻松开启高效的 AI 智能编程之旅。 下载 快捷键（Win/Linux）或（macOS） ：运行默认构建工具（通常是 ），适合日常写作，自动处理多遍编译 右键 → “Build LaTeX project” ：同上，但可在右键菜单中切换构建工具（如临时用 单步调试） 保存文件时自动编译 ：需开启设置 = ；但注意：仅当焦点在 文件时才触发，且不会运行 等辅助工具，除非 配置正确 若修改了 文件，必须手动触发一次构建（ ），否则参考文献不会刷新 PDF 预览与反向同步失效的典型原因 预览窗口打不开、点击 PDF 跳不到源码、点源码跳不到 PDF —— 这些几乎都源于编译日志中未生成正确的 文件或路径映射错误。 检查编译日志末尾是否有 ；若无，说明 启动参数未带 （LaTeX Workshop 默认已加，但自定义 tool 配置可能覆盖） 项目含中文路径（如 ）会导致 SyncTeX 失效，务必使用纯 ASCII 路径 预览窗口右上角三个点 → “Open in Browser” 可绕过内建 PDF 查看器限制；反向同步（Ctrl+Click）仅在内建查看器中有效，且要求 PDF 已加载完成（状态栏显示 ） 若使用 或 拆分文件，主文件必须是当前打开的活动编辑器，否则跳转定位会错乱 真正卡住人的往往不是功能有没有，而是 没读到你的 、 在 VS Code 里没继承、或者 被 杀毒软件 锁住删掉了——先看日志，再查路径，最后动配置。