【亲测免费】 LaTeX Workshop 安装和配置指南

1. 项目基础介绍和主要编程语言

项目基础介绍

LaTeX Workshop 是一个为 Visual Studio Code (VS Code) 开发的扩展，旨在通过提供预览、编译、自动补全、语法高亮等功能，提升 LaTeX 排版的效率。该项目由 James Yu 发起，并得到了社区的广泛贡献。

主要编程语言

LaTeX Workshop 主要使用 TypeScript 和 JavaScript 进行开发。

2. 项目使用的关键技术和框架

关键技术

• LaTeX：用于文档排版的标记语言。
• Visual Studio Code：一个轻量级但功能强大的源代码编辑器。
• Docker：用于在容器中运行 LaTeX 环境。
• WSL (Windows Subsystem for Linux)：在 Windows 上运行 Linux 环境。

框架

• VS Code Extension API：用于开发 VS Code 扩展的 API。
• LaTeX 编译工具：如 pdflatex, xelatex, lualatex 等。

3. 项目安装和配置的准备工作和详细安装步骤

准备工作

1. 安装 Visual Studio Code：

   • 访问 VS Code 官网 下载并安装 VS Code。

2. 安装 LaTeX 发行版：

   • 推荐安装 TeX Live 或 MikTeX。
   • 访问 TeX Live 官网 或 MikTeX 官网 下载并安装。

3. 配置环境变量：

   • 确保 LaTeX 的可执行文件路径（如 pdflatex）已添加到系统的 PATH 环境变量中。

详细安装步骤

1. 安装 LaTeX Workshop 扩展：

   • 打开 VS Code。
   • 点击左侧活动栏中的扩展图标（或按 Ctrl+Shift+X）。
   • 在搜索框中输入 LaTeX Workshop。
   • 找到 LaTeX Workshop 扩展并点击 Install。

2. 配置 LaTeX Workshop：

   • 打开 VS Code 的设置（按 Ctrl+,）。
   • 搜索 LaTeX Workshop，找到相关设置项进行配置。
   • 例如，设置默认的 LaTeX 编译工具：

     "latex-workshop.latex.toolchain": [
         {
             "command": "pdflatex",
             "args": [
                 "-synctex=1",
                 "-interaction=nonstopmode",
                 "-file-line-error",
                 "%DOC%"
             ]
         }
     ]
     

3. 使用 LaTeX Workshop：

   • 在 VS Code 中创建或打开一个 .tex 文件。
   • 使用快捷键 Ctrl+Alt+B 编译 LaTeX 文档。
   • 使用快捷键 Ctrl+Alt+V 预览生成的 PDF 文件。

高级配置（可选）

1. 使用 Docker：

   • 安装 Docker 并配置 latex-workshop.docker.enabled 为 true。
   • 参考 Docker 支持文档 进行详细配置。

2. 使用 WSL：

   • 在 Windows 上启用 WSL，并安装 Linux 发行版。
   • 在 VS Code 中安装 Remote - WSL 扩展，并在 WSL 中使用 LaTeX Workshop。

通过以上步骤，您可以顺利安装和配置 LaTeX Workshop，开始在 VS Code 中高效地进行 LaTeX 文档编写和排版。