1. 为什么你需要TeX Live 2024,以及如何避开那些“经典”的坑
如果你正在为论文、报告或者书籍的排版发愁,尤其是那些包含复杂公式、优雅参考文献和精美图表的内容,那么LaTeX几乎是你绕不开的工具。而TeX Live,作为LaTeX世界的“官方发行版”,就是你开启这一切的基石。2024年的新版本带来了更快的编译速度、更好的字体管理以及对最新宏包的原生支持,可以说是一次相当值得的升级。
但我知道,很多朋友,尤其是刚接触科研或者学术写作的同学,一听到“安装配置”就头大。网上教程五花八门,有的让你装老旧的CTeX套装,结果和现在的模板冲突不断;有的安装步骤复杂得像解谜游戏;还有的装完了,编辑器却不知道怎么和TeX Live“牵手成功”,写个“Hello World”都报错。我自己早些年也没少踩坑,曾经因为一个路径配置问题折腾了一下午。所以,这篇攻略的目的就是让你用最省心、最高效的方式,一次搞定TeX Live 2024和现代编辑器的配置,把时间真正花在写作上,而不是和环境搏斗。
简单来说,TeX Live就是一个庞大的工具箱,里面包含了LaTeX编译引擎、成千上万个宏包(可以理解为插件或扩展)、各种字体以及辅助工具。你写的.tex源文件,需要这个工具箱里的“工人”(编译器)来加工,最终生成漂亮的PDF。而编辑器,比如VS Code,就是你指挥这些工人的控制台和写字板。我们的目标就是让这个控制台精准、流畅地指挥工具箱。这次我们完全抛弃过时的集成套装,拥抱纯净、跨平台且维护积极的TeX Live 2024,并搭配目前最主流的编辑器方案,保证你无论是在Windows、macOS还是Linux上,都能获得一致的顺畅体验。
2. TeX Live 2024 的安装:一条清晰的路径
安装TeX Live,最忌讳的就是去官网直接下那个在线安装器,网速不稳定的时候简直是噩梦。我们采用最稳妥、最快速的方式——下载ISO镜像文件进行本地安装。这就像你拿到了一个完整的软件安装盘,所有东西都在里面,不受网络波动影响。
2.1 获取安装镜像:选择最近的“快递站”
TeX Live在全球有很多镜像站点,就像仓库的分发点。从离你最近的镜像站下载,速度最快。对于国内用户,清华大学和北京外国语大学的镜像站是绝佳选择。
- 清华大学镜像站:
https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/Images/ - 北京外国语大学镜像站:
https://mirrors.bfsu.edu.cn/CTAN/systems/texlive/Images/
打开以上任意一个链接,你会找到一个名为 texlive2024.iso 的文件(具体文件名可能带有日期,如 texlive2024-20240315.iso)。直接点击下载,或者复制链接地址到迅雷等下载工具中,速度会非常快。我实测用迅雷下载,百兆宽带下不到20分钟就能搞定这个约4GB的镜像文件。
2.2 安装过程详解:每一步都心中有数
下载完成后,你会得到一个.iso文件。在Windows 11/10系统上,你可以直接双击它,系统会将其挂载为一个虚拟光驱(比如G:盘)。在macOS上,双击也可能直接打开,或者你需要使用一些工具(如hdiutil命令)。Linux用户则可以用mount命令挂载。
进入这个虚拟光驱,你会看到一堆文件。我们只需要关注其中一个:
- Windows用户:找到
install-tl-windows.bat,右键点击它,选择“以管理员身份运行”。这一步很重要,能避免后续因权限不足导致的安装失败。 - macOS用户:对应的安装程序是
install-tl(一个Unix脚本)。你需要在终端(Terminal)中,先cd到挂载的目录,然后执行sudo ./install-tl。 - Linux用户:同样,在终端中定位到挂载目录,运行
sudo ./install-tl。
以Windows为例,运行批处理文件后,会弹出一个黑底蓝字的命令行安装界面。别被它吓到,其实很友好。
- 欢迎界面:直接按
I键(代表Install)开始安装。如果你想先看看选项,可以按C进入高级配置。 - 安装目录:默认会安装在
C:\texlive\2024。如果你的C盘空间紧张(安装需要约8GB空间),可以在这里修改。我建议如果空间够,就用默认路径,能减少很多潜在的路径配置麻烦。按D可以修改目录。 - 安装方案:默认是“完整安装”(Full scheme)。这会把所有宏包、字体、文档都装上,大约8GB。对于绝大多数用户,我强烈推荐完整安装。这样以后你遇到任何期刊模板,几乎都不会缺宏包,一劳永逸。除非你的硬盘空间真的捉襟见肘,才考虑“最小安装”或“自定义安装”。
- 创建开始菜单快捷方式:建议保持默认的“是”。这样以后你可以在开始菜单找到TeX Live的管理器。
- 安装后调整系统PATH:这个选项务必选择“是”。它会把TeX Live的可执行文件目录(比如
C:\texlive\2024\bin\win64)添加到系统的环境变量PATH中。这是后续编辑器能自动找到TeX Live编译器的关键一步! - 文件关联:可以选择将
.tex文件关联给TeXworks(TeX Live自带的简易编辑器),这个可以随意,因为我们主要用更强大的编辑器。
设置完毕后,再次按 I 开始安装。接下来就是漫长的文件复制过程,根据你的电脑性能,大约需要30分钟到1小时。泡杯茶,休息一下。安装程序最后会提示“安装成功”,此时关闭窗口即可。
安装后的重要检查:为了确保安装完全成功且PATH配置生效,请打开一个新的命令行窗口(Win+R,输入cmd或powershell),输入命令 xelatex --version 并回车。如果能看到输出XeLaTeX的版本信息(如“XeTeX 3.141592653...”),那么恭喜你,TeX Live已经成功安装并配置好了系统路径。这个检查动作能帮你提前发现90%的后续问题。
3. 编辑器的选择与深度配置:让写作如虎添翼
有了强大的TeX Live引擎,我们还需要一个称手的编辑器。我不再推荐WinEdt,虽然它经典,但它是商业软件,且生态相对封闭。这里我主推两款免费、强大且跨平台的现代化选择:VS Code 和 TeXstudio。你可以根据喜好二选一。
3.1 方案一:VS Code + LaTeX Workshop(全能之选)
VS Code以其轻量、扩展性强和无敌的生态,成为了许多人的主力编辑器。配置LaTeX环境后,它提供的体验非常现代化。
-
安装VS Code:从官网下载安装,这一步很简单。
-
安装扩展:打开VS Code,点击侧边栏的扩展图标,搜索“LaTeX Workshop”,找到由James Yu开发的这个扩展,点击安装。这是VS Code里LaTeX支持的灵魂。
-
基本配置:安装后其实已经可以用了,但为了更高效,我们需要调整一些设置。按下
Ctrl+,打开设置,在搜索框输入“latex-workshop.latex.recipes”,我们需要配置编译链。 点击“在settings.json中编辑”,会打开一个JSON配置文件。我推荐加入以下配置,它定义了几种常用的编译方式:"latex-workshop.latex.recipes": [ { "name": "xelatex -> bibtex -> xelatex*2", "tools": [ "xelatex", "bibtex", "xelatex", "xelatex" ] }, { "name": "lualatex", "tools": [ "lualatex" ] }, { "name": "pdflatex", "tools": [ "pdflatex" ] } ], "latex-workshop.latex.tools": [ { "name": "xelatex", "command": "xelatex", "args": [ "-synctex=1", "-interaction=nonstopmode", "-file-line-error", "%DOCFILE%" ] }, { "name": "lualatex", "command": "lualatex", "args": [ "-synctex=1", "-interaction=nonstopmode", "-file-line-error", "%DOCFILE%" ] }, { "name": "pdflatex", "command": "pdflatex", "args": [ "-synctex=1", "-interaction=nonstopmode", "-file-line-error", "%DOCFILE%" ] }, { "name": "bibtex", "command": "bibtex", "args": [ "%DOCFILE%" ] } ], "latex-workshop.view.pdf.viewer": "tab", "latex-workshop.latex.autoBuild.run": "onSave", "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", "*.synctex.gz" ]这段配置做了几件事:定义了三种编译配方(recipe),其中第一个
xelatex -> bibtex -> xelatex*2是处理带有参考文献(BibTeX)的文档的标准流程;定义了每个编译工具(如xelatex)的具体命令参数;设置了PDF在VS Code内置标签页中预览;设置了保存时自动编译(可根据习惯关闭);定义了清理辅助文件时的类型。 -
使用与技巧:打开一个
.tex文件,你会看到左侧活动栏多了一个TeX图标。点击它,可以看到编译、预览、查看日志等所有功能。你可以点击“Recipe”选择一种编译方式,然后点击“Build”进行编译。编译成功后,会自动在右侧打开PDF预览。正向搜索(从TeX代码跳转到PDF对应位置):在代码中按Ctrl+Alt+J。反向搜索(从PDF点击跳回代码):在PDF预览里,按住Ctrl键点击内容即可。这种无缝跳转对于长文档调试至关重要。
3.2 方案二:TeXstudio(开箱即用)
如果你觉得VS Code配置稍显复杂,或者想要一个专门为LaTeX定制的、功能齐全且开箱即用的IDE,那么TeXstudio是你的不二之选。它界面专业,功能集中,对LaTeX新手非常友好。
- 下载与安装:从TeXstudio官网下载对应系统的安装包,安装过程无脑下一步即可。
- 配置TeX路径:绝大多数情况下,TeXstudio能自动检测到已安装的TeX Live。为了确认,打开TeXstudio,进入
选项->设置TeXstudio->命令。检查“TeX发行版”下的路径(如pdflatex、xelatex的路径)是否指向你的TeX Live 2024的bin目录。如果是自动检测到的,通常就是正确的。 - 配置构建命令:在“命令”设置页,找到“构建”选项。默认命令可能是
pdflatex -synctex=1 -interaction=nonstopmode %.tex。我建议将默认编译器改为XeLaTeX以更好地支持中文和现代字体,你可以添加一个自定义命令,或者直接修改默认命令为xelatex -synctex=1 -interaction=nonstopmode %.tex。对于需要参考文献的文档,可以使用内置的“快速构建”(F5),它默认会处理BibTeX。 - 配置PDF查看器:TeXstudio内置了PDF预览器,通常不需要额外配置。正向/反向搜索功能默认就是开启的。在代码编辑区按
Ctrl+鼠标单击可以正向搜索,在PDF预览区Ctrl+鼠标单击可以反向搜索,非常方便。
VS Code vs TeXstudio 怎么选? 如果你已经是VS Code用户,或者喜欢一个编辑器搞定所有编程/写作任务,乐于折腾配置以获得高度定制化,选VS Code。如果你想要一个专注于LaTeX、无需太多配置、功能强大且稳定的“专业工作站”,选TeXstudio。两者都能提供极高的生产效率。
4. 高效工作流与实用技巧
环境搭好了,但要真正高效,还得掌握一些工作流和技巧。这些是我多年用LaTeX写论文、报告积累下来的实战经验,能帮你节省大量时间。
4.1 项目管理与文件组织
千万不要把所有东西都扔在一个文件夹里。一个清晰的论文项目结构应该是这样的:
你的论文项目/
├── main.tex # 主文档
├── preamble.tex # 导言区设置(单独文件,干净利落)
├── chapters/ # 章节文件夹
│ ├── introduction.tex
│ ├── methodology.tex
│ └── conclusion.tex
├── figures/ # 图片文件夹
│ ├── fig1.pdf
│ └── diagram.svg
├── data/ # 数据文件夹(可选)
├── references.bib # BibTeX参考文献数据库
└── build/ # 编译输出文件夹(可选,用于存放生成的辅助文件)
在主文档main.tex里,使用\input{}或\include{}命令来组织章节。使用graphicx宏包并设置\graphicspath{{figures/}},这样插入图片时只需写文件名,不用写长路径。将所有的宏包设置、自定义命令都放在preamble.tex里,让主文档非常简洁。这种结构不仅清爽,也便于版本控制(如Git)。
4.2 编译优化与问题排查
编译出错是常事,别慌。首先看错误信息,编译器通常会在日志(.log文件)里告诉你出错的行号和可能原因。VS Code的LaTeX Workshop扩展和TeXstudio都会在编译失败时高亮显示错误行。
- 常见错误“File ended while scanning...”:这通常是缺少闭合的括号
}、花括号}或者环境结束符\end{...}。仔细检查错误行附近的代码结构。 - “Undefined control sequence”:通常是拼错了命令名,或者没加载必要的宏包。检查命令拼写,并确认是否用
\usepackage{}引入了对应宏包。 - 参考文献和引用显示问号“??”:这说明你需要运行BibTeX。确保你的编译流程包含了
bibtex步骤(就像我们在VS Code配置的recipe里那样)。编译顺序通常是:xelatex->bibtex->xelatex->xelatex。 - 清理辅助文件:当遇到奇怪的错误,或者想从头编译时,把那些
.aux,.log,.bbl,.blg等辅助文件删除(VS Code和TeXstudio都有清理功能),然后重新编译,往往能解决很多玄学问题。
4.3 宏包管理与更新
TeX Live 2024自带了一个强大的包管理器——tlmgr(TeX Live Manager)。你可以在命令行中使用它来更新、安装或卸载宏包。
- 更新所有已安装的包和TeX Live自身:以管理员身份打开命令行,运行
tlmgr update --self --all。这个操作会先更新tlmgr自己,然后更新所有宏包。建议定期(比如每季度)执行一次。 - 搜索宏包:
tlmgr search --global --file 关键词。例如,你想找关于表格的宏包,可以搜tlmgr search --global --file table。 - 安装宏包:
tlmgr install 宏包名。例如,安装一个很棒的绘图宏包tikz:tlmgr install pgf(tikz是pgf宏包的一部分)。
记住,在VS Code或TeXstudio里写代码时,如果提示某个命令未定义,很可能就是缺少宏包。去CTAN网站搜索一下命令名或功能,找到对应的宏包名,再用tlmgr安装即可。
5. 针对特定平台的额外提示
虽然TeX Live是跨平台的,但不同系统在安装后可能还有些细微差别需要注意。
对于macOS用户:你们安装的其实是MacTeX,它本质上就是TeX Live加上一些macOS特有的工具和字体。安装过程更图形化,基本是下一步到底。安装完成后,环境变量通常会自动配置好。需要注意的是,在终端(Terminal)首次使用tex相关命令前,可能需要先运行 sudo tlmgr path add 来确保路径被正确添加到shell配置中。编辑器(如VS Code)的配置流程与Windows完全一致。
对于Linux用户:虽然很多发行版的仓库也提供了TeX Live包,但版本往往较旧。我强烈建议按照本文的方法,从TUG官方镜像下载ISO进行安装,这样可以获得最新且最完整的版本。安装时需要root权限(sudo)。安装完成后,同样记得将TeX Live的bin目录路径(例如/usr/local/texlive/2024/bin/x86_64-linux)添加到你的shell配置文件(如~/.bashrc或~/.zshrc)中,添加一行 export PATH=/usr/local/texlive/2024/bin/x86_64-linux:$PATH,然后执行 source ~/.bashrc 使其生效。
最后,无论你用哪个平台、哪个编辑器,在开始一个重要的写作项目前,我建议先用一个简单的测试文档验证整个环境是否工作正常。创建一个test.tex文件,写入以下内容:
\documentclass{article}
\usepackage{fontspec} % XeLaTeX/LuaLaTeX下设置字体
\setmainfont{TeX Gyre Termes} % 选择一个系统有的字体
\begin{document}
Hello, \LaTeX! 这是一段中文测试。
这是一个公式:$E = mc^2$。
\end{document}
用XeLaTeX编译它,看看是否能成功生成PDF,并且中文和公式都显示正常。这个简单的测试能一次性验证编译器、字体、编辑器配置等多个环节,确保你的“武器库”处于随时可用的战备状态。做完这些,你就可以自信地开始你的LaTeX排版之旅了,把精力完全投入到内容创作本身,让工具成为你得力的助手,而不是绊脚石。
3万+



被折叠的 条评论
为什么被折叠?



