hegerdes/vscode-latex Docker Image Overview

hegerdes/vscode-latex

基于TeXLive的VSCode LaTeX环境镜像，提供快速配置的完整LaTeX开发环境，支持x86/arm/arm64架构，集成Pandoc、Git、VSCode扩展（如LaTeX Workshop、拼写检查）和科学项目模板，适用于本地或远程容器开发，支持多语言和持久化配置。

0 次下载

😅 镜像要是出问题，背锅的一定是你

中文简介版本下载

😅 镜像要是出问题，背锅的一定是你

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。