【ShuQiHere】配置和使用 VS Code + LaTeX Workshop：全方位指南

ShuQiHere

于 2024-10-10 00:00:00 发布

阅读量908

点赞数 19

分类专栏：【ShuQiHere】大战Linux系统三百回合文章标签： latex

本文链接：https://blog.csdn.net/wangshuqi666/article/details/142771696

版权

【ShuQiHere】大战Linux系统三百回合专栏收录该内容

11 篇文章 0 订阅

订阅专栏

配置和使用 VS Code + LaTeX Workshop：全方位指南 🚀

目录 📑

引言
什么是 LaTeX 以及为什么选择 LaTeX Workshop？
安装步骤
LaTeX 使用小窍门
在 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 = mc^2$

这个公式就是著名的 爱因斯坦质能方程，它用 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 来表示实数集 $\mathbb{R}$ ，使用 \deriv{y}{x} 来表示导数 $\dfrac{d y}{d x}$ 。

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$ 的图像。

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$ 的图像，带有坐标轴和图例。

💡 小提示：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 编写顺利！ 🎉