macOS下配置VSCode+Latex Workshop+Docker中文LaTeX环境

简述

本文目的是记录我在macOS下配置LaTeX中文环境的过程。

LaTeX文本编辑器我还是喜欢VSCode+Latex Workshop组合，私以为其优秀是有目共睹的，不然网络上也不会有这么多配置教程。

但是不同于大多数既有的博客文章，本文中我选择将TexLive放进Docker容器而非在macOS中安装MacTex/TexLive。因为我并非经常使用LaTeX来写作，不喜欢MacTex套件总是出现在我的启动台中。

如果你希望通过安装MacTex的方式在Mac上配置VSCode+Latex Workshop，那么本文对你的帮助有限，建议移步网上其他优秀的中文教程。

本文总体分为两大部分——

1. Docker镜像的构建
2. VSCode+Latex Workshop的配置

基础环境

1. macOS Catalina 10.15.2 Beta
2. Docker Desktop 2.1.0.4 (39773) stable
3. Visual Studio Code 1.40.1 stable
4. LaTeX Workshop by James Yu v8.4.1

对于上述软件/插件的安装不予详述。

Docker镜像的构建

首先，我们需要一个TexLive的Docker镜像。

当然，在Docker Hub上搜索texlive或latex等关键词就可以找到一些相关的镜像，比如mirisbowring/texlive_ctan_full这个似乎就不错。但我本着爱折腾的原则选择自己构建镜像。

我的Dockerfile如下，可供参考

FROM yousiki/ubuntu:tuna-build

LABEL maintainer="yousiki"

RUN apt update && \
    apt install -y \
        wget \
        libfontconfig1 \
        build-essential && \
    apt autoremove -y && \
    apt clean && \
    rm -rf /var/lib/apt/lists/*

ADD texlive2019-20190410 /install-texlive

WORKDIR /install-texlive

RUN chmod +x install-tl && \
    echo "selected_scheme scheme-full" >> texlive.profile && \
    ./install-tl -profile texlive.profile && \
    rm -rf /install-texlive

ENV PATH="/usr/local/texlive/2019/bin/x86_64-linux:${PATH}"
ENV MANPATH="/usr/local/texlive/2019/texmf-dist/doc/man:${MANPATH}"
ENV INFOPATH="/usr/local/texlive/2019/texmf-dist/doc/info:${INFOPATH}"

RUN tlmgr option repository \
        https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet && \
    tlmgr update --self --all

VOLUME [ "/workspace" ]

WORKDIR /workspace

其中，texlive2019-20190410就是TexLive2019安装镜像解压后的目录，附上清华TUNA镜像。

这里有一些我曾经踩过的坑，比如缺失wget软件会使tlmgr update或tlmgr install