1. 为什么选择VSCode写LaTeX？

第一次接触LaTeX时，我试过各种专用编辑器：Texmaker、TeXstudio、Overleaf...但最后发现VSCode才是真香选择。原因很简单：专注一个编辑器搞定所有事。就像你不会为了写邮件专门装个邮件客户端一样，能用VSCode完成的事情何必再开其他软件？

实测下来，VSCode配合LaTeX Workshop插件能实现：

• 实时预览：右侧分屏显示PDF，修改内容秒级刷新
• 智能补全：输入\beq自动补全为\begin{equation}
• 错误定位：编译报错时直接跳转到源码对应行
• 版本控制：Git集成让论文修改历史一目了然

最近帮学弟配置环境时，他原本用Word写公式写到崩溃，切换到这个方案后感叹："原来写公式可以像写代码一样流畅！"

2. 从零搭建LaTeX环境

2.1 Texlive安装避坑指南

安装Texlive就像给电脑装"LaTeX语言包"，这里推荐2023版（虽然教程里写2020，但新版兼容性更好）。我亲测过三种安装方式：

1. 在线安装（不推荐）

   • 官网下载install-tl-windows.exe
   • 耗时4小时+，网络波动可能中断

2. ISO镜像安装（推荐）

   # 清华镜像地址（替换xxxx为当前年份）
   https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/Images/texlivexxxx.iso
   

   • 下载后挂载镜像运行install-tl-advanced.bat
   • 勾选"创建快捷方式"（否则得手动添加环境变量）

3. Mac用户专属

   brew install --cask mactex
   

注意：安装时建议勾选"安装所有宏包"（约8GB），避免后期缺包。我有次写论文到凌晨发现少了个冷门包，等下载等到怀疑人生...

2.2 宏包管理实战技巧

安装完打开TeX Live Manager（开始菜单搜索tlmgr），这几个命令超实用：

# 更新所有宏包
tlmgr update --all

# 搜索特定包（如中文支持）
tlmgr search ctex

# 安装缺失包
tlmgr install algorithm2e

遇到"repository not found"错误？试试换国内源：

tlmgr option repository https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet

3. LaTeX Workshop插件深度配置

3.1 基础配置三步走

1. 安装插件：VSCode扩展商店搜索"LaTeX Workshop"
2. 创建测试文件：新建test.tex输入：

   \documentclass{article}
   \begin{document}
   Hello \LaTeX!
   \end{document}
   

3. 编译测试：点击左侧TEX图标→Build LaTeX project

这时候你可能会遇到第一个坑——中文乱码。别急，往下看解决方案。

3.2 中文支持终极方案

在settings.json中加入这段配置（Ctrl+,搜索settings）：

{
  "latex-workshop.latex.recipes": [
    {
      "name": "XeLaTeX",
      "tools": ["xelatex"]
    }
  ],
  "latex-workshop.latex.tools": [
    {
      "name": "xelatex",
      "command": "xelatex",
      "args": [
        "-synctex=1",
        "-interaction=nonstopmode",
        "-file-line-error",
        "%DOCFILE%"
      ]
    }
  ],
  "latex-workshop.view.pdf.viewer": "tab"
}

关键点解释：

• xelatex比pdflatex对中文支持更好
• synctex=1实现PDF与源码双向跳转
• tab模式让PDF在VSCode内显示

3.3 参考文献编译黑科技

写论文最头疼的就是参考文献编译，试试这个"四步法"配方：

{
  "name": "xelatex → bibtex → xelatex ×2",
  "tools": ["xelatex", "bibtex", "xelatex", "xelatex"]
}

为什么需要编译四次？因为：

1. 第一次生成.aux文件
2. bibtex读取.aux生成.bbl
3. 后两次确保交叉引用正确

4. 高效写作技巧大全

4.1 代码片段加速输入

在VSCode用户片段中添加（File → Preferences → User Snippets）：

{
  "Equation Environment": {
    "prefix": "beq",
    "body": [
      "\\begin{equation}",
      "\t$1",
      "\\end{equation}"
    ]
  }
}

输入beq按Tab键，自动生成公式环境。我常用的还有：

• fig → 图片环境
• tab → 表格环境
• item → 列表环境

4.2 自定义构建快捷键

嫌每次点菜单太慢？绑定快捷键到keybindings.json：

{
  "key": "ctrl+alt+b",
  "command": "latex-workshop.build"
}

4.3 终极分屏方案

推荐这样布局：

+------------+------------+
|            |            |
|  源码.tex  |  预览PDF   |
|            |            |
+------------+------------+
|            |            |
|  日志输出  |  参考文献  |
|            |            |
+------------+------------+

设置方法：

1. 右键标签页选择"Split Right"
2. 拖拽日志面板到底部
3. 使用Ctrl+/Ctrl-调整缩放

5. 疑难杂症解决方案

5.1 突然无法编译？

先检查这三处：

1. 文件路径是否含中文或空格（最好全英文）
2. 是否安装了所有依赖宏包
3. 终端执行xelatex -v看是否报错

5.2 PDF预览不更新？

尝试：

1. 关闭PDF标签页重新编译
2. 在设置中开启自动刷新：

   "latex-workshop.view.pdf.autoReload.enabled": true
   

5.3 公式渲染异常？

99%的问题可以通过添加这些宏包解决：

\usepackage{amsmath}
\usepackage{amssymb}
\usepackage{bm}

最近帮同学debug时发现，某些期刊模板会覆盖数学字体设置，这时候需要强制指定：

\DeclareMathVersion{normal}
\SetSymbolFont{operators}{normal}{OT1}{cmr} {m}{n}