用 VSCode 写 LaTeX 完全可行，关键在配置简洁、插件得当、编译链清晰；需安装 TeX 发行版并配置好 PATH，再装 LaTeX Workshop 等核心插件，设好主文档与编译规则即可高效使用。
用 VSCode 写 LaTeX 完全可行，而且体验不输专业 IDE——关键在配置简洁、插件得当、编译链清晰。下面是一套经过验证、开箱即用的全流程配置方案，覆盖安装、环境搭建、常用功能和避坑要点。
安装基础环境：TeX 发行版 + VSCode
VSCode 本身不处理 LaTeX 编译，它只是编辑器，真正干活的是背后的 TeX 引擎（如 pdfTeX、XeLaTeX、LuaLaTeX）。所以第一步是装一个完整的 TeX 发行版：
- Windows 推荐 TeX Live（完整版）或 MiKTeX（更轻量，按需安装宏包）；安装时勾选「添加到系统 PATH」，否则 VSCode 找不到命令
- macOS 推荐 MacTeX（含 TeX Live + GUI 工具）；安装后终端输入 xelatex --version 能返回版本号才算成功
- Linux 用户可直接用包管理器安装：Ubuntu/Debian 运行 sudo apt install texlive-full（或至少 texlive-latex-recommended texlive-fonts-recommended texlive-latex-extra）
- VSCode 从官网下载安装即可，无需额外配置
核心插件安装与设置
只需两个插件就能支撑绝大多数需求，避免插件冲突：
- LaTeX Workshop（必装）：功能最全的 LaTeX 插件，支持自动编译、实时预览、结构导航、引用跳转、错误定位等
- LaTeX Utilities（可选但推荐）：补全命令、快速插入环境、生成参考文献条目等，提升书写效率
安装后，在 VSCode 设置中（Ctrl+, / Cmd+,）搜索 latex-workshop.latex.recipes，确认默认配方（recipe）为 latexmk（推荐）或 xelatex；再检查 latex-workshop.latex.autoBuild.run 设为 onSave 或 onFileChange，实现保存即编译。
项目结构与主文档配置
一个干净的 LaTeX 项目建议这样组织：
本文档主要讲述的是Python开发网站指南；HTML是网络的通用语言,一种简单、通用的全置标记语言。它允许网页制作人建立文本与图片相结合的复杂页面，这些页面可以被网上任何其他人浏览到，无论使用的是什么类型的电脑或浏览器 Python和其他程序语言一样，有自身的一套流程控制语句，而且这些语句的语法和其它程序语言类似，都有for, if ,while 类的关键字来表达程序流程。希望本文档会给有需要的朋友带来帮助；感兴趣的朋友可以过来看看
- 根目录放 main.tex（主文档），所有编译从此开始
- 用 \input{} 或 \include{} 拆分章节到 ch1-intro.tex、sec-methods.tex 等子文件
- 图片统一放在 figures/，宏包和自定义命令写在 preamble.tex 并用 \input{preamble} 引入
LaTeX Workshop 默认识别 main.tex 为主文件。如果主文件名不同（比如叫 thesis.tex），可在其开头加注释：% !TEX root = thesis.tex，插件就会以此为编译入口。
编译、预览与调试技巧
编译不是“点一下就完事”，理解背后逻辑才能少踩坑：
- 按 Ctrl+Alt+B（Win/Linux）或 Cmd+Alt+B（Mac）触发编译；状态栏左下角会显示进度和结果
- PDF 预览默认内嵌在 VSCode 右侧（点击 PDF 标签页即可），支持同步滚动（PDF → 编辑器）和反向搜索（编辑器 → PDF，需启用 SyncTeX）
- 遇到“未定义控制序列”或“找不到 .bst 文件”，先看终端输出（LaTeX Workshop 底部面板 → LaTeX Log），多数是拼写错误、宏包缺失或路径问题
- 中文支持推荐用 ctex 宏包（XeLaTeX/LuaLaTeX），在导言区加 \usepackage{ctex} 即可，不用手动设字体
基本上就这些。配置一次，后续新建项目复制粘贴结构，改改主文件名就能复用。不复杂但容易忽略 PATH 和主文件声明，这两步卡住的人最多。
