hegerdes/vscode-latex
hegerdes
基于TeXLive的VSCode LaTeX环境镜像，提供快速配置的完整LaTeX开发环境，支持x86/arm/arm64架构，集成Pandoc、Git、VSCode扩展（如LaTeX Workshop、拼写检查）和科学项目模板，适用于本地或远程容器开发，支持多语言和持久化配置。
下载次数: 0状态：社区镜像维护者：hegerdes仓库类型：镜像最近更新：23 天前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
LaTeX VSCode 镜像
镜像概述与主要用途
该镜像旨在与VSCode配合使用，提供快速、功能完备的LaTeX开发环境。基于TeXLive构建，支持本地或远程容器开发，集成多种工具和VSCode扩展，简化LaTeX入门流程，提升大型项目开发效率。项目代码仓库：https://github.com/hegerdes/VSCode-LaTeX-Container
核心功能与特性
- 基于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 https://github.com/hegerdes/VSCode-LaTeX-Container code VSCode-LaTeX-Container # 在VSCode中按F1 > Remote-Containers: 在容器中重新打开 # 等待初始拉取和构建完成 # 注意：需安装Docker和VSCode远程扩展 # 搜索扩展包："ms-vscode-remote.vscode-remote-extensionpack"
容器内设置
整个项目位于容器内部：
bash# 打开VSCode # 在VSCode中按F1 > Remote-Containers: 在容器卷中克隆仓库 > https://github.com/hegerdes/VSCode-LaTeX-Container # 等待初始拉取和构建完成 # 注意：需安装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]
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 vscode-latex 镜像标签
docker pull docker.xuanyuan.run/hegerdes/vscode-latex:<标签>
DockerHub 原生拉取命令
docker pull hegerdes/vscode-latex:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"