LaTeX VSCode 镜像

镜像概述与主要用途

该镜像旨在与VSCode配合使用，提供快速、功能完备的LaTeX开发环境。基于TeXLive构建，支持本地或远程容器开发，集成多种工具和VSCode扩展，简化LaTeX入门流程，提升大型项目开发效率。项目代码仓库：GitHub

核心功能与特性

• 基于TeXLive的快速、干净、可工作的LaTeX环境配置
• Pandoc支持，用于不同格式间的项目转换
• 跨主机操作系统兼容
• 支持x86/arm/arm64架构
• 可在远程计算机上部署环境
• 性能优于Windows上的MiKTeX
• 预装LaTeX Workshop和LaTeX Utilities扩展（仅VSCode）
• Markdown支持（仅VSCode）
• 拼写检查功能（仅VSCode）
• 持久化bash_history（仅VSCode）
• Git版本控制支持
• 支持自定义用户或添加更多工具
• 科学项目模板（仅VSCode）

使用场景与适用范围

• 本地LaTeX项目开发（主机源码通过卷挂载）
• 容器内完整项目管理（项目完全位于容器中）
• 多架构开发环境（x86/arm/arm64设备）
• 多语言科学论文、报告编写（支持中文、日文、德文等多语言镜像）
• 远程协作开发（通过容器共享统一环境）

详细使用方法与配置说明

快速开始

本地设置

TeX源码位于主机系统，通过卷挂载到容器中：

bash
# 打开终端并输入：
git clone [***]
code VSCode-LaTeX-Container
# 在VSCode中按F1
> Remote-Containers: 在容器中重新打开
# 等待初始拉取和构建完成
# 注意：需安装Docker和VSCode远程扩展
# 搜索扩展包："ms-vscode-remote.vscode-remote-extensionpack"

容器内设置

整个项目位于容器内部：

bash
# 打开VSCode
# 在VSCode中按F1
> Remote-Containers: 在容器卷中克隆仓库
> [***]
# 等待初始拉取和构建完成
# 注意：需安装Docker和VSCode远程扩展
# 搜索扩展包："ms-vscode-remote.vscode-remote-extensionpack"

Docker镜像说明

基础镜像与架构

• 基于debian（bullseye版本，buster已弃用）和ubuntu（focal版本，bionic已弃用）构建
• 支持x86/arm/arm64架构

镜像类型

• 标准镜像：包含texlive、texlive-latex-extra、texlive-lang-english、texlive-luatex、texlive-xetex、texlive-pstricks、texlive-science、latexmk、cm-super、chktex，以及git、zsh、pandoc（非alpine版本）等工具
• 精简镜像（slim）：仅包含texlive、texlive-latex-extra、texlive-lang-english、latexmk、cm-super、chktex，体积较小但可能缺少部分工具
• 完整镜像（full）：包含LaTeX生态几乎所有工具（不含文档），体积较大但工具齐全
• 语言特定镜像：基于bullseye-base和focal-base构建，支持多语言，包括：all、arabic、chinese、cjk、cyrillic、czechslovak、english、european、french、german、greek、italian、japanese、korean、other、polish、portuguese、spanish。通过修改devcontainer.json中的VARIANT参数指定，如bullseye-lang-chinese或ubuntu-lang-french

更新计划

每两个月更新一次镜像

关于项目由来

我一直喜欢LaTeX专注内容而非格式的理念，但入门门槛较高。最初使用MiKTeX和TeXworks，后转向VSCode与LaTeX Workshop，体验良好。但发现Windows上MiKTeX速度远慢于Linux，而我需要跨系统高效开发环境。在本科论文研究开发环境与容器工具时，我整合了这些需求，创建了此镜像。现有latex镜像（如tianon/latex）大多过时，因此自建镜像，虽体积较大，但确保工具齐全，避免手动安装依赖的麻烦，希望能帮助更多人轻松使用LaTeX。

更新日志

2022年1月22日

• 弃用debian-buster和ubuntu-bionic
• 将pandoc从2.13版本升级至2.14

2021年7月21日

• 从microsoft vscode基础镜像迁移至纯debian/ubuntu基础镜像
• 新增debian bullseye支持
• 移除debian stretch支持
• 镜像体积减小40%
• 默认用户改为latex
• 将pandoc从2.13版本升级至2.14
• 为ARM支持做准备
• 将spellright扩展替换为valentjn.vscode-ltex

2021年6月6日

• 更新基础镜像
• 添加拼写检查扩展
• 更新演示PDF

2021年5月19日

• 初始发布
• 支持debian-buster|stretch[-slim]
• 支持ubuntu-focal|bionic[-slim]