LaTeX发行版安装配置教程

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

本文介绍在不同操作系统下如何安装和配置$\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 User Settings，回车打开用户设置settings.json文件。在文件中的{}中添加以下代码：

// 编译工具和命令
"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文件。

环境配置测试文档

新建一个文档，复制下面代码，保存到一个工作目录（空文件夹）中（方便统一管理生成的中间文件），编译运行查看是否可以生成PDF文件。

% !TEX program = xelatex
\documentclass{article}
\usepackage{ctex}

\title{\LaTeX{}测试文档}
\author{Invinc-Z}
\date{\today}  % 自动显示当前日期

\begin{document}
\maketitle  % 生成标题

\section{引言}
这是一个测试\LaTeX{}环境是否正确配置的文档，使用XeLaTeX编译。

\subsection{二级标题}
这是二级标题下的内容。

\end{document}

CTEX

CTEX一般用于排版一些模板比较旧的中文期刊和毕业论文等，可查看需要排版的模板的说明或者更新时间，如果时间比较久远，优先安装旧版本2.9.2.167（不要安装2.9.2.164，系统环境变量Path过长可能被覆盖，就是别的变量值都没了）。

官网网站：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文件名带了空格，删除空格后可以跳转。

Ubuntu24.04

Tex Live安装

下载镜像文件并装载

由于后续内容涉及字体和文本编辑, 建议用户先确定系统内是否已经有 fontconfig 和 gedit，需在Terminal中执行

1	sudo apt install fontconfig gedit

下载镜像文件，该文件夹下包含 3 个 .iso 文件，这 3 个文件仅有文件名不同，内容完全相同，可以任选一个下载。将下载的镜像进行装载

1 2	sudo mkdir /mnt/texlive sudo mount ./texlive2025.iso /mnt/texlive

开始安装

接下来执行

1	sudo /mnt/texlive/install-tl

进行安装。在屏幕上应该能见到以下内容

======================> TeX Live installation procedure <=====================
 
======>   Letters/digits in <angle brackets> indicate   <=======
======>   menu items for actions or customizations      <=======
= help>   https://tug.org/texlive/doc/install-tl.html   <=======
 
 Detected platform: GNU/Linux on x86_64
 
 <B> set binary platforms: 1 out of 15
 
 <S> set installation scheme: scheme-full
 
 <C> set installation collections:
     40 collections out of 41, disk space required: 8779 MB (free: 970330 MB)
 
 <D> set directories:
   TEXDIR (the main TeX directory):
     /usr/local/texlive/2025
   TEXMFLOCAL (directory for site-wide local files):
     /usr/local/texlive/texmf-local
   TEXMFSYSVAR (directory for variable and automatically generated data):
     /usr/local/texlive/2025/texmf-var
   TEXMFSYSCONFIG (directory for local config):
     /usr/local/texlive/2025/texmf-config
   TEXMFVAR (personal directory for variable and automatically generated data):
     ~/.texlive2025/texmf-var
   TEXMFCONFIG (personal directory for local config):
     ~/.texlive2025/texmf-config
   TEXMFHOME (directory for user-specific files):
     ~/texmf
 
 <O> options:
   [ ] use letter size instead of A4 by default
   [X] allow execution of restricted list of programs via \write18
   [X] create all format files
   [X] install macro/font doc tree
   [X] install macro/font source tree
   [ ] create symlinks to standard directories
   [X] after install, set CTAN as source for package updates
 
 <V> set up for portable installation
 
Actions:
 <I> start installation to hard disk
 <P> save installation profile to 'texlive.profile' and exit
 <Q> quit
 
Enter command:

点击键盘I进行默认安装，默认安装是为所有用户安装。（硬盘容量紧张可点击键盘C并回车进行精简安装，输入集合对应的字母可以选中/取消选中相应宏包功能，支持批量输入，如deghijkstuvwxyznoABCEHIKLMNS，后续可通过 tlmgr 工具来单独安装它们，因此不用太担心）。默认安装安装完毕后, 系统会提示用户添加环境变量，例如

1
2
3

export PATH=/usr/local/texlive/2025/bin/x86_64-linux:$PATH
export MANPATH=/usr/local/texlive/2025/texmf-dist/doc/man:$MANPATH
export INFOPATH=/usr/local/texlive/2025/texmf-dist/doc/info:$INFOPATH

此处显示信息可能会略有不同，比如电脑使用了基于 arm64 架构的处理器，则 x86_64-linux 将被替换为aarch64-linux。为安全起见, 用户需将此处的系统提示记录。

弹出装载的光盘镜像并删除文件夹

将装载的光盘镜像弹出并删除文件夹, 即执行

1 2	sudo umount /mnt/texlive sudo rm -r /mnt/texlive

设置环境变量

对于bash，可以修改 ~/.bashrc 文件，执行vim ~/.bashrc或其他任意文本编辑器（gedit、vi、nano等）打开~/.bashrc文件，

在打开的文件末尾添加刚刚记录的系统提示, 如

#Add TeX Live to the PATH, MANPATH, INFOPATH
export PATH=/usr/local/texlive/2025/bin/x86_64-linux:$PATH
export MANPATH=/usr/local/texlive/2025/texmf-dist/doc/man:$MANPATH
export INFOPATH=/usr/local/texlive/2025/texmf-dist/doc/info:$INFOPATH

并保存退出，重启 bash 或者执行命令 source ~/.bashrc 来重载 bash 配置。

验证安装是否成功

然后退出当前用户并重新登录, 再打开 Terminal 并执行

tex -v

若显示

TeX 3.141592653 (TeX Live 2025)
kpathsea version 6.4.1
Copyright 2025 D.E. Knuth.
There is NO warranty. Redistribution of this software is
covered by the terms of both the TeX copyright and
the Lesser GNU General Public License.
For more information about these matters, see the file
named COPYING and the TeX source.
Primary author of TeX: D.E. Knuth.

即为安装成功。

刷新字体缓存

接下来处理字体。在 Terminal 中执行

1	sudo cp /usr/local/texlive/2025/texmf-var/fonts/conf/texlive-fontconfig.conf /etc/fonts/conf.d/09-texlive.conf

将配置文件复制到系统，然后继续执行

1	sudo fc-cache -fsv

刷新字体缓存。这样一来, TEX Live 中的字体才能够被正确调用。如果用户更改了安装路径, 要注意将 /usr/local/texlive/2025/在各处替换。

升级与安装宏包

升级所有宏包包括tlmgr自身：

1	sudo $(which tlmgr) update --self --all

安装指定宏包：

1	sudo $(which tlmgr) install mcmthesis

Mac系统

✏ ✏ ✏

参考文章

一份简短的关于LATEX安装的介绍
Tex live指南-2025
TeX Live 2025 安装教程（Windows/WSL/Linux）