LaTeX发行版安装配置教程

发表于 2025-03-28 更新于 2025-10-30 分类于 LaTeX ， LaTeX环境配置阅读次数：本文字数： 2k 阅读时长 ≈ 10 分钟

本文介绍在不同操作系统下如何安装和配置\(\LaTeX{}\)的发行版（包括TeX Live、CTEX套装和MacTeX），并且介绍了一些常用的编辑器的安装和配置。

前言

\(\TeX\)/\(\LaTeX\) 并不是单独的程序，现在的TeX系统都是复杂的软件包，里面包含各种排版的引擎、编译脚本、格式转换工具、管理界面、配置文件、支持工具、字体及数以千计的宏包和文档。一个TeX发行版就是把所有这样的部件整合起来，打包发布的软件。

什么是\(\TeX\)/\(\LaTeX\)，CTEX套装、TeX Live、MacTex、MiKTeX这些是什么，xelatex、pdflatex、lualatex这些又是什么，如何通过一堆代码就能生成优雅的pdf文件，底层究竟发生了什么？

关于这些问题可参考一份简短的LaTeX相关术语的介绍。

关于\(\LaTeX{}\)环境的安装配置也可参考一份简短的关于LATEX安装的介绍，关于TeX Live的介绍和安装参考Tex live指南，\(\LaTeX{}\)的基础知识和入门使用可参考一份（不太）简短的LATEX2ε 介绍。

若本地Tex Live环境已经安装配置好，可在本地打开一些使用手册，具体命令如下：

1
2
3

texdoc install-latex-guide-zh-cn    # 一份简短的关于LATEX安装的介绍
texdoc texlive-zh-cn                # Tex live指南
texdoc lshort-zh-cn                 # 一份（不太）简短的LATEX2ε 介绍

其中texdoc是 TeX Live 发行版中自带的一个命令行工具，用于快速查找和打开 TeX 相关的文档（包括宏包、程序或格式的手册、说明等）。类似于Linux系统的man手册。

本文主要介绍如何安装和配置latex的运行环境。TeX Live可配合Texstudio或VS Code编辑器使用，CTEX套装配合WinEdt编辑器使用。这些配套方案是流行的、容易设置的、经过验证行之有效的搭配方法。

Windows系统

Tex Live安装

图形界面安装步骤

下载镜像文件;
在英文路径下解压texlive.iso文件（或右键装载，完成安装后再弹出），右键install-tl-windows.bat，以管理员身份打开；
选择安装路径（使用英文不带括号的路径），点击安装；
漫长等待，安装完成

texlive2025安装完成界面如下：

（可能是去掉了欢迎界面，查看安装目录下texlive\2025\install-tl.log最后出现 欢迎进入 TeX Live 的世界！的日志，基本上可以放心点击关闭） 5. Win+R输入cmd，分别输入tex -v，latex -v，xelatex -v，pdflatex -v进行验证。

命令行安装步骤

下载镜像文件.iso，并装载；

以管理员方式打开cmd，切换到装载磁盘；

输入 install-tl-windows.bat --no-gui；

输入D 设置路径，再输入1来改变安装路径，之后输入 d:/install/texlive/2025；

输入R返回主菜单，之后输入I开始安装。

历史版本

有些模板使用特定年份版本的TeX Live，可从下面网址获取，一般用清华镜像的就行。

texlive历史版本
清华镜像历史版本

Texstudio安装

安装包下载：

官网主页
国内镜像
历史版本

安装步骤：傻瓜式安装，中间可以切换安装路径，不带中文路径，C盘容量较小可以切换其他盘符。

VSCode环境配置

打开VS Code，点击左侧扩展图标，搜索LaTeX Workshop,点击第一个进行下载安装。
配置环境，在VS Code界面快捷键Ctrl Shift + P，输入Open Settings，回车打开Settings.json文件。在文件中的{}中添加以下代码：

Show Code

// 编译工具和命令
    "latex-workshop.latex.tools": [
        {
            "name": "pdflatex",
            "command": "pdflatex",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "%DOCFILE%"
            ]
        },
        {
            "name": "xelatex",
            "command": "xelatex",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "%DOCFILE%"
            ]
        },
        {
            "name": "bibtex",
            "command": "bibtex",
            "args": [
                "%DOCFILE%"
            ]
        }
    ],
    // 用于配置编译链
    "latex-workshop.latex.recipes": [
        {
            "name": "xelatex",
            "tools": [
                "xelatex"
            ],
        },
        {
            "name": "pdflatex",
            "tools": [
                "pdflatex"
            ]
        },
        {
            "name": "xe->bib->xe->xe",
            "tools": [
                "xelatex",
                "bibtex",
                "xelatex",
                "xelatex"
            ]
        },
        {
            "name": "pdf->bib->pdf->pdf",
            "tools": [
                "pdflatex",
                "bibtex",
                "pdflatex",
                "pdflatex"
            ]
        }
    ],
     //文件清理。此属性必须是字符串数组
    "latex-workshop.latex.clean.fileTypes": [
        "*.aux",
        "*.bbl",
        "*.blg",
        "*.idx",
        "*.ind",
        "*.lof",
        "*.lot",
        "*.out",
        "*.toc",
        "*.acn",
        "*.acr",
        "*.alg",
        "*.glg",
        "*.glo",
        "*.gls",
        "*.ist",
        "*.fls",
        "*.log",
        "*.fdb_latexmk"
    ],
    //tex文件浏览器，可选项为"none" "browser" "tab" "external"
    "latex-workshop.view.pdf.viewer": "tab",
    //设置是否自动编译tex文件
    "latex-workshop.latex.autoBuild.run": "never",
    //右键菜单，显示内容菜单：（1）编译文件；（2）定位游标
    "latex-workshop.showContextMenu": true,
    //显示错误
    "latex-workshop.message.error.show": false,
    //显示警告
    "latex-workshop.message.warning.show": false,
    //从使用的包中自动补全命令和环境
    "latex-workshop.intellisense.package.enabled": true,
    //设置为never，为不清除辅助文件
    "latex-workshop.latex.autoClean.run": "never",
    //设置vscode编译tex文档时的默认编译链
    "latex-workshop.latex.recipe.default": "lastUsed",
    // 用于反向同步的内部查看器的键绑定。ctrl/cmd +点击(默认)或双击
    "latex-workshop.view.pdf.internal.synctex.keybinding": "double-click",

编译.tex文件打开Latex模板，打开*.tex文件夹，这时发现左侧多了一个TEX的图标，这就是LaTeX Workshop扩展。

点击它打开，再点击左上角构建LaTeX中的配方条目，根据*.tex文件要求选择不同的条目进行编译。

编译失败则会显示×，其左侧的!显示的是警告，点击可以查看原因。点击上方的预览按钮，即可查看生成的*.pdf文件。

CTEX

CTEX一般用于排版一些模板比较旧的中文期刊和毕业论文等，可查看需要排版的模板的说明或者更新时间，如果时间比较久远，优先安装旧版本2.9.2。

官网网站：https://ctex.org/

稳定版本

CTeX 3.0.216.3

下载图中三个文件，其中CTeX_3.0.215.2_Full.exe为32位/64位通用版本，CTeX_3.0.215.2_Full.nsisbin是数据文件，CTeX_3.0.216.3_Update.exe是更新文件。

下载后将这三个文件放在同一文件夹下，以管理员方式启动exe文件开始安装，安装路径选择不带中文路径与空格，安装时间取决于具体机型。安装完成后提示是否在线更新miktex，选择否，安装时间较长，后面可根据需要更新宏包。

旧版本2.9.2

CTeX_2.9.2.167_Full.exe

安装步骤：傻瓜式安装，中间可以切换安装路径，不带中文路径，C盘容量较小可以切换其他盘符。

WinEdt11

CTEX2.9.2版本安装后默认的编辑器为WinEdt7.0，CTEX3.0以上版本默认编辑器为WinEdt11.1。目前WinEdt官网最新版本为11.2，可进行覆盖安装，具体方法是安装时将路径设置为CTEX安装路径下面的WinEdt文件夹，例如：D:\install\CTEX\WinEdt。

注意：一定不要卸载CTEX自带的WinEdt。完成覆盖安装后，打开WinEdt 11，会出现Warning警告提示本地配置是之前的版本，要你按照提示进行更新（Options->Maintenance->Upgrade Local…，按照提示的步骤进行即可）进行更新升级，并重新存储更新后的本地配置即可。

可用注册码：

1 2	name: *60[20220501] Warez_Down [RU-BOARD] (100 users) code:4049089118892183088

无法双向跳转（No SyncTex Data”“）的问题可能是由于tex文件名带了空格，删除空格后可以跳转。

Linux系统

待续…