【ShuQiHere】配置和使用 VS Code + LaTeX Workshop：全方位指南
配置和使用 VS Code + LaTeX Workshop：全方位指南
目录
- 引言
- 什么是 LaTeX 以及为什么选择 LaTeX Workshop？
- 安装步骤
- 1. 安装 VS Code 和 LaTeX Workshop 插件
- 2. 安装 LaTeX 编译工具
- 3. 验证安装
- 4. 使用 LaTeX Workshop 编写和编译文档
- LaTeX 使用小窍门
- 1. 自动补全和宏定义
- 2. 使用数学环境
- 3. 管理参考文献
- 在 LaTeX 中绘制函数
- 1. 使用 TikZ 绘图
- 2. 使用 PGFPlots 绘制函数图像
- 常见问题与解决方案
- 总结
引言
在现代学术和技术写作中，LaTeX 是一款无可替代的工具。它能够帮助我们编写高质量的论文、报告、书籍等，并在数学公式、图表和参考文献管理方面拥有强大的功能。✨
这篇博客将会一步步教你如何使用 Visual Studio Code (VS Code) 和 LaTeX Workshop 插件来高效地编写 LaTeX 文档。不论你是 LaTeX 新手还是熟练用户，这篇博客都会帮助你充分利用 LaTeX 和 VS Code 的强大功能。
什么是 LaTeX 以及为什么选择 LaTeX Workshop？
什么是 LaTeX？
LaTeX 是一种基于 TeX 的排版系统，专为复杂文档的排版而设计。与传统的所见即所得（WYSIWYG）文档编辑器不同，LaTeX 采用一种更接近编程的方式来生成最终文档。通过这种方式，LaTeX 可以轻松处理数学公式、表格、图形以及文献引用等复杂排版任务。
例如，你可以轻松地写出一个漂亮的数学公式：
E = m c 2 E = mc^2 E=mc2
这个公式就是著名的 爱因斯坦质能方程，它用 LaTeX 表达得如此优雅，而如果使用普通的文字处理器可能需要非常复杂的操作。
为什么选择 VS Code 和 LaTeX Workshop？
VS Code 是一款强大的代码编辑器，支持众多插件和自定义功能。LaTeX Workshop 是其中一款为 LaTeX 用户设计的插件，它具有以下几个优势：
- 实时预览 PDF：你可以在编写 LaTeX 文档的同时，实时查看编译的 PDF 输出，避免频繁切换窗口。
- 自动补全和语法高亮：提高编写效率，减少手动输入错误。
- 一键编译：通过内置的命令，你可以一键编译文档，生成 PDF。
- 跨平台支持：VS Code 和 LaTeX Workshop 可以在 Windows、macOS 和 Linux 上无缝运行。
安装步骤
1. 安装 VS Code 和 LaTeX Workshop 插件
- 访问 VS Code 官网 下载并安装 Visual Studio Code。
- 安装完成后，打开 VS Code。
- 点击左侧的 扩展图标（四方形图标），然后在搜索栏输入 LaTeX Workshop。
- 找到由 James Yu 开发的 LaTeX Workshop 插件，点击 Install 安装。
安装完成后，你会看到 LaTeX Workshop 出现在已启用的扩展列表中。
2. 安装 LaTeX 编译工具
要使用 LaTeX Workshop 插件编译 .tex 文件，你需要安装 LaTeX 发行版。我们推荐安装 TeX Live 或 MiKTeX，因为它们包含了所有必要的 LaTeX 工具。
对于 Linux 系统的用户：
你可以通过以下命令安装 TeX Live 和 latexmk：
sudo apt install texlive-full
sudo apt install latexmk
- TeX Live：是一个完整的 LaTeX 发行版，包含了常用的工具如
pdflatex、xelatex等。 - latexmk：是一个自动化 LaTeX 构建工具，能够管理多个 LaTeX 编译步骤。
小提示：安装 texlive-full 可能需要一些时间，因为它包含了所有的 LaTeX 包。
对于 Windows 用户：
可以下载并安装 MiKTeX 或 TeX Live。安装完成后，确保它们的路径已被添加到系统的环境变量中。
3. 验证安装
安装完成后，你可以通过以下命令来确认 LaTeX 工具是否正确安装：
pdflatex --version
latexmk --version
你应该能够看到它们的版本信息。如果没有，请检查 LaTeX 工具是否正确安装，或者手动将其路径添加到系统的 $PATH 环境变量中。
4. 使用 LaTeX Workshop 编写和编译文档
现在，所有工具都已安装完成，你可以开始在 VS Code 中编写 LaTeX 文档了！
- 打开 VS Code，创建一个新文件，保存为
.tex格式，例如main.tex。 - 在文件中编写以下简单的 LaTeX 文档：
\documentclass{article}
\usepackage[utf8]{inputenc}
\usepackage{amsmath}
\title{My First LaTeX Document}
\author{Your Name}
\date{\today}
\begin{document}
\maketitle
\section{Introduction}
This is a simple LaTeX document written in VS Code. Let's include a famous equation:
\begin{equation}
E = mc^2
\end{equation}
\section{More Math}
Here is the quadratic formula:
\[
x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}
\]
\end{document}
- 保存文件后，点击右上角的 编译按钮，或按下
Ctrl + Alt + B来编译文档。VS Code 将自动打开右侧的 PDF 预览，显示编译结果。
️ 小技巧：如果你希望使用 xelatex 或其他编译器，可以通过在 LaTeX Workshop 设置中自定义工具链。
LaTeX 使用小窍门
为了让你的 LaTeX 编写更加高效，这里提供一些实用的小技巧。
1. 自动补全和宏定义
LaTeX Workshop 提供了强大的自动补全功能，但你也可以自定义一些宏来简化常用的命令。
例如，在文档的导言区（\begin{document} 之前），你可以定义新的命令：
\newcommand{\R}{\mathbb{R}}
\newcommand{\deriv}[2]{\dfrac{d #1}{d #2}}
这样，在文档中，你可以使用 \R 来表示实数集 R \mathbb{R} R，使用 \deriv{y}{x} 来表示导数 d y d x \dfrac{d y}{d x} dxdy。
2. 使用数学环境
LaTeX 提供了多种数学环境，善用这些环境可以让公式排版更加优美。
- 行间公式：使用
$...$或\( ... \)，例如$E=mc^2$。 - 独立公式：使用
\[ ... \]或\begin{equation} ... \end{equation}，可自动编号。 - 多行公式：使用
align环境，方便对齐多个公式。
例如：
\begin{align}
a^2 + b^2 &= c^2 \\
e^{i\pi} + 1 &= 0
\end{align}
3. 管理参考文献
使用 BibTeX 可以方便地管理参考文献。
- 创建一个
.bib文件（例如references.bib），添加参考文献信息：
@article{Einstein1905,
author = {Einstein, Albert},
title = {On the Electrodynamics of Moving Bodies},
journal = {Annalen der Physik},
year = {1905},
volume = {17},
pages = {891-921}
}
- 在主
.tex文件中引用：
As discussed in \cite{Einstein1905}, the theory of relativity...
\bibliographystyle{plain}
\bibliography{references}
在 LaTeX 中绘制函数
绘制函数图形是学术论文中常见的需求。LaTeX 提供了强大的绘图包，如 TikZ 和 PGFPlots，可以用于创建高质量的图形。
1. 使用 TikZ 绘图
TikZ 是一个强大的绘图包，可以用于绘制简单的图形和函数。
首先，在导言区引入 TikZ 包：
\usepackage{tikz}
然后，在文档中绘制函数：
\begin{tikzpicture}
\draw[->] (-3,0) -- (3,0) node[right] {$x$};
\draw[->] (0,-1) -- (0,5) node[above] {$y$};
\draw[domain=-2.5:2.5,smooth,variable=\x,blue] plot ({\x},{\x*\x});
\node at (2,4) {$y = x^2$};
\end{tikzpicture}
上述代码将绘制出函数 y = x 2 y = x^2 y=x2 的图像。
2. 使用 PGFPlots 绘制函数图像
PGFPlots 基于 TikZ，专门用于绘制函数和数据图形，语法更简洁。
首先，引入 PGFPlots 包：
\usepackage{pgfplots}
\pgfplotsset{compat=1.17}
然后，在文档中绘制函数：
\begin{tikzpicture}
\begin{axis}[
axis lines = middle,
xlabel = {$x$},
ylabel = {$y$},
]
\addplot[
domain=-2:2,
samples=100,
color=red,
]
{x^3 - x};
\addlegendentry{$y = x^3 - x$}
\end{axis}
\end{tikzpicture}
这将绘制函数 y = x 3 − x y = x^3 - x y=x3−x 的图像，带有坐标轴和图例。
小提示：PGFPlots 可以绘制更加复杂的图形，如三维曲面、柱状图、散点图等。
常见问题与解决方案
1. 错误：spawn latexmk ENOENT
这是由于没有安装 latexmk。你可以使用以下命令安装：
sudo apt install latexmk
2. 实时预览无法显示？
如果编译成功但看不到 PDF 预览，按 Ctrl + Alt + V 来手动打开 PDF 预览窗口。如果问题仍然存在，请确保 LaTeX Workshop 已正确启用，并且系统允许插件访问文件系统。
总结
通过善用 LaTeX 的强大功能和 LaTeX Workshop 插件，你可以极大地提升文档编写的效率和质量。无论是复杂的数学公式、精美的图形，还是规范的参考文献管理，LaTeX 都能帮你轻松实现。✨
记得多尝试不同的包和功能，不断丰富你的 LaTeX 技能！
希望这些新增的 LaTeX 使用小窍门和绘制函数的示例对你有所帮助，祝你 LaTeX 编写顺利！