很多Windows用户被TeXLive安装劝退其实多半不是TeXLive本身的问题而是下载源没选对、安装方式没想清楚或者被Windows路径上的小事坑了。尤其是装完之后在终端里敲xelatex找不到命令、安装过程跑到一半卡住、因为Windows用户名是中文导致编译失败这几种情况我身边已经见过太多回。这篇就围绕Windows上完整安装TeXLive这件事把从下载、安装、验证到常见排错的全过程讲清楚尽量让你一次装对。1. 装之前先搞清楚这几件事1.1 为什么Windows上首选TeXLive而不是其他发行版Windows上可用的TeX发行版主流是TeXLive和MiKTeX两种。很多人纠结选哪个我可以直接说结论如果你不想后期为宏包问题折腾选TeXLive。MiKTeX的特点是按需安装你写文档用到某个宏包时它才现场下载优点是首次安装体积小缺点也在这里——每次编译都可能联网拉包慢不说一旦网络源不稳定或者换了一台离线电脑缺一个包就卡住一次。而且不同用户之间宏包状态不一致经常出现我这边能编译你那边报缺少xxx.sty的场面。TeXLive是年度发行一年一个大版本里面包含的宏包非常全。完整安装完绝大多数情况下你不需要再额外装包编译时该有的都在。它不像MiKTeX那么轻量但换来的是省心和稳定。对需要在不同电脑间迁移项目、或者做学术论文写作的人来说宏包齐全带来的确定性远比省几个GB磁盘空间重要。1.2 下载渠道TUG官网不一定是最好的选择很多人习惯直接去TUG官网tug.org下载结果下载速度忽快忽慢一个ISO文件断断续续下了半天好不容易下完了一校验哈希还不一致直接崩心态。TUG官网服务器在国外国内下载体验确实不稳定。推荐走国内镜像源速度和稳定性都有保障常用的有清华TUNA镜像mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/Images/中科大USTC镜像mirrors.ustc.edu.cn/CTAN/systems/texlive/Images/阿里云镜像mirrors.aliyun.com/CTAN/systems/texlive/Images/这几个镜像站都同步了TeXLive的官方安装镜像。打开后你会看到很多文件重点是两个texlive2025.iso完整的离线安装镜像体积大概在5GB上下每年版本号不同文件大小略有差异。这适合一次性下载、安装后续不需要网络太多参与。install-tl.zip一个很小的网络安装引导包下载下来只有几MB。它是通过脚本在线拉取全部组件。这个方式后续还有用处但新手我不建议直接用理由后面详细说。注意这里的2025只是版本号示例TeXLive每年更新一次实际使用时以镜像站上最新的年份为准。1.3 安装前的环境体检我习惯在动手前先花两分钟检查Windows环境避免安装到一半出幺蛾子。磁盘空间。完整安装TeXLive 2025大概占用8GB到10GB左右的空间之后宏包更新还会继续增加。建议安装前确认你的系统盘一般是C盘至少有20GB可用空间。如果空间不够后面更新宏包时会很难受。系统体系结构。现在绝大多数Windows都是64位了TeXLive也提供了对应的64位版本安装包。如果你想确认自己的系统是32位还是64位可以在终端里执行echo $env:PROCESSOR_ARCHITECTUREPowerShell或者echo %PROCESSOR_ARCHITECTURE%CMD输出AMD64就是64位x86就是32位。官方近年已经逐步放弃32位支持如果你还在用32位系统可能需要找旧版本这个情况比较少见。杀毒软件和Windows Defender。不是说要卸载杀毒软件而是建议在安装编译期间暂时关闭某些实时防护或者至少允许texlive相关的bat脚本和程序运行。安装过程中要创建大量文件、修改PATH环境变量有些防护软件会拦截这类行为导致安装看似成功但实际不完整。我见过好几个案例就是Defender把install-tl-windows.bat的某个子进程杀了安装界面显示100%完成但xelatex.exe根本没被放出来。路径问题。这是Windows用户最容易忽略的安装包放的路径和计划安装的路径尽量都不要出现中文、空格和特殊符号。如果你的Windows用户名本身是中文比如C:\Users\张三后续编译时会出现一些奇葩问题这个在第5节专门展开讲。先把这条记住安装包放纯英文路径下运行。2. 在线安装和离线安装两条路线背后的原理2.1 在线安装的工作机制install-tl.zip解压出来之后里面有一个install-tl-windows.bat脚本它是整个安装流程的启动器。双击运行后脚本会读取你指定的仓库地址Repository也就是远程宏包仓库然后一个个地把宏包下载到本地并解压到安装目录。安装完成后这个临时下载的脚本目录其实就没用了。在线安装的优缺点非常明显优点是安装包体积小从下载到开始安装的时间短。缺点是安装过程严重依赖网络。仓库里的宏包数以千计一旦中途某个包下载失败、连接超时安装脚本可能重试或中断。中断后虽然可以再次运行脚本但整个过程的进度记录有时不太明朗对新手来说自己搞不清楚上次装到哪了。2.2 离线安装为什么更适合大多数Windows用户离线安装就是用ISO镜像文件来安装镜像里面已经包含了全部宏包相当于你本机就有一个完整的仓库。安装过程在绝大多数时间内是本地解压复制只有在安装完成后的更新阶段才需要网络。我自己的经验是Windows下优先选择离线ISO安装。原因有两层。第一层网络依赖降到最低。国内即使走镜像源单个宏包下载还好但要连续请求几千个包任何一个环节抖动都可能让整个安装前功尽弃。而ISO安装不存在这个问题99%的动作都是本地磁盘读写。第二层便于重复安装和救急。ISO文件下载一次存到移动硬盘里以后在任何一台Windows电脑上都能用它离线装TeXLive不需要依赖网络环境。单位内网机器、实验室离线电脑这种场景离线ISO几乎是唯一可行方案。2.3 安装目录与路径规划里的门道TeXLive在Windows上的默认安装路径是C:\texlive\2025。这个路径看起来很复古但它是很有讲究的路径短后续命令行操作省事没有空格。很多编译工具和宏包对带空格的路径支持并不好C:\Program Files\TeXLive这样的路径看着正规实际使用中反而容易出问题;不需要管理员权限来运行日常命令。所以我的建议很直接不要自己创意性地改到D:\Program Files\texlive或者D:\tex live这种路径除非你确实有特殊理由。如果系统盘空间紧张可以改成D:\texlive\2025这种短路径但路径里绝对不要出现空格和特殊字符。3. 离线安装包的完整安装流程以Windows 11为例3.1 拿到ISO文件后先做校验和预处理从镜像站下载ISO文件后不要急着双击先校验一下文件完整性。这一步能过滤掉绝大多数因为网络导致的坏安装包问题。Windows自带的certutil命令就可以计算文件哈希。打开PowerShell切换到下载目录运行certutil -hashfile .\texlive2025.iso SHA256把计算出来的哈希值和镜像站页面提供的texlive2025.iso.sha256文件比对一下。一致说明文件完整不一致就重新下载。校验通过后Windows 8以上的系统可以直接右键ISO文件选择装载把它当成一个虚拟光驱打开。也可以直接右键解压到某个纯英文目录比如D:\texlive-iso。这两种方式等价看你习惯。注意解压路径不要带中文。3.2 图形界面安装适合第一次接触的人进入挂载或解压出来的目录里面能找到install-tl-windows.bat双击运行。这里稍微等一下脚本会先启动一个图形界面窗口实际上是一个Perl/Tk窗口所以长得比较朴素。界面里最重要的几个设置Installation scheme安装方案默认是full schemeeverything这就是全量安装包含所有宏包和工具。新手就保持这个不要为了省空间选medium或者small否则你写中文文档用ctex、画图用tikz的时候就会发现缺包。Installation directory安装目录默认C:\texlive\2025就行。Add to system PATH默认是勾选的必须保持勾选。这个选项会把C:\texlive\2025\bin\windows添加到系统环境变量PATH中安装后你才能在终端里直接使用xelatex、pdflatex等命令。设置完之后点击界面下方的Install TeX Live按钮开始安装。整个完整安装过程需要一段时间通常在二三十分钟左右取决于磁盘速度。装到一半看到进度条长时间不动先别急着关窗口有的宏包文件特别大解压耗时久看起来像卡住了而已。3.3 命令行参数化安装适合重装和批量部署如果你有命令行使用经验其实更推荐用参数化安装。以管理员身份打开PowerShell进入ISO解压目录运行.\install-tl-windows.bat --no-interaction --schemefull--no-interaction表示不弹出交互界面直接采用默认安装配置并开始安装。配合--schemefull强制使用完整方案。这样安装过程会以文本进度条的形式在终端里输出相比图形界面更直观也不容易遇到Tk窗口在远程桌面或某些精简系统上无法正常显示的问题。如果不想用默认的C:\texlive\2025可以再加--install-dir参数指定路径例如.\install-tl-windows.bat --no-interaction --schemefull --install-dirD:\texlive\2025但再次提醒路径要短、纯英文、无空格。命令行安装完成后脚本同样会自动配置环境变量不需要手动处理。3.4 安装过程中容易被忽略的坑安装期间不要手欠去关窗口。install-tl-windows.bat在运行时会启动多个子进程尤其是解压文件阶段可能有一段时间窗口看起来没反应。很多人就是看到进度条慢以为死机了直接强制关闭结果开关了一半。另外强烈建议安装期间暂时关闭一些国产电脑管家类软件的安装拦截功能。这类软件经常会把texlive的写入操作当成异常行为弹窗拦截。默认安装是几十个小文件往系统目录里写任何一个被拦截都可能导致安装完成后某条命令不可用。4. 安装完成后的三个必做检查安装脚本显示完成不代表一切搞定。以下三个检查建议按顺序做一遍能帮你把99%的隐患提前暴露出来。4.1 环境变量检查确认命令真的能用重新打开一个新的PowerShell或CMD窗口一定要新开窗口旧窗口不会刷新环境变量执行xelatex -v如果输出一长串版本信息说明环境变量配置正确xelatex已经可以被直接调用。如果提示无法识别xelatex命令或者不是内部或外部命令说明PATH环境变量没有生效。别急手动添加即可右键此电脑 → 属性 → 高级系统设置 → 环境变量。在系统变量里找到Path双击编辑新建一行填入你的TeXLive bin目录路径比如C:\texlive\2025\bin\windows。确定保存重新开一个终端窗口验证。这个bin目录下可以看到xelatex.exe、pdflatex.exe、tlmgr.bat这些可执行文件手动添加路径时指向的就是这个目录。4.2 编译一个真正的中文文档环境变量没问题后建议立刻编译一个中文文档做验证。这里用xelatex而不是pdflatex因为xelatex对中文支持更友好。新建一个文件test.tex内容如下\documentclass{article} \usepackage{ctex} \begin{document} 你好世界。TeXLive 安装成功 \end{document}然后在文件所在目录打开终端执行xelatex test.tex如果过程中没有报错最终生成了test.pdf说明你的环境可以正常编译中文文档。这一步非常重要很多人的安装其实是成功的但在写中文文档时用了pdflatex编译遇到一堆字体或编码错误误以为安装有问题。pdflatex对中文的支持需要额外配置而xelatex配合ctex宏包是当前Windows中文写作最省心的组合。这里还牵扯一个编码问题tex源文件需要保存为UTF-8格式。Windows自带的记事本默认保存可能是UTF-8带BOM部分编辑器对BOM处理不佳会导致编译报错。推荐用VS Code、Notepad这些编辑器把文件编码明确设置为UTF-8无BOM。4.3 编辑器选型和基础配置TeXLive自带了一个简单的编辑器TeXworks界面朴素但功能很齐全适合新手体验编译一下看看的感觉。缺点是自动补全和错误提示比较弱写大文档时效率一般。我更推荐的组合看你的需求VS Code LaTeX Workshop插件适合习惯现代编辑器的人。安装插件后在设置里把编译工具指定为xelatex保存后可以一键编译错误日志集成在终端里配合SyncTeX还能点击PDF跳转到对应源码位置。TeXstudio则是专为LaTeX设计的编辑器内置了文献管理、结构导航、公式预览等功能对不熟悉命令行的人来说更加直观。它的默认配置里可以直接把默认编译器设为XeLaTeX中文支持设置好后同样很好用。工具没有绝对好坏关键是选一个把编译命令和源文件编码这两件事管好的编辑器。5. Windows用户最常见的报错与排查方法5.1 用户名是中文导致的问题如果Windows用户名是中文例如C:\Users\张三你在编译文档时可能会遇到一些很费解的报错。比如有些工具在临时目录中创建文件而临时目录路径继承自用户目录中文字符在部分程序内部编码转换时出错导致编译中途崩溃。还有latexmk这类自动化编译脚本对当前工作目录路径中的中文也很敏感。这个问题的解决办法有几种按推荐程度排序修改用户目录路径为英文。系统级的解决办法是新建一个管理员账号用户名用英文把原来的文件迁移过去。这是最彻底的方式但操作成本高。把系统环境变量TEMP和TMP指向英文路径。在系统变量中新增或修改TEMP和TMP为C:\Temp这样的纯英文目录能解决相当一部分程序创建临时文件时的中文路径问题。把译工作目录放到纯英文路径。如果你只是受限于当前用户名编译文件的时候尽量把项目放在D:\texprojects这类纯英文目录下不要在桌面或者文档这种带有中文用户名路径的目录里操作。说实话这个问题在Windows上属于历史遗留问题不是TeXLive自己能修好的。尽早把用户目录改成英文后面省心很多。5.2 命令找不到环境变量没生效前面第4节已经讲了手动添加环境变量的方法。这里补充一个常见情况安装时明明勾选了Add to system PATH安装后终端里也找不到命令。这往往是因为你安装时用的终端窗口是管理员权限打开而安装完成后测试时用的是普通权限窗口或者反过来。Windows的环境变量在不同权限级别的窗口之间不会实时同步尽量新开窗口测试。5.3 编译报错缺宏包和字体问题编译时最常见的一行报错LaTeX Error: File xxx.sty not found.意思是缺宏包。虽然TeXLive全量安装包含绝大多数宏包但总有一些稍冷门的宏包不在默认集合里。这种情况用包管理器安装即可tlmgr install 宏包名比如缺framed.sty就执行tlmgr install framed。如果提示找不到这个包先在CTAN上确认一下包的真实名称有些宏包名和\usepackage参数并不是完全一致的。字体类报错在Windows下也比较常见特别是使用某些商业中文字体或从网上下载的字体时。报错信息中会提到字体名无法识别。解决办法是确认字体已经安装到了Windows的字体目录中然后在LaTeX文档中正确指定字体名称。使用ctex宏包时可以通过\setCJKmainfont{字体名}的方式显式指定。6. 日常更新与卸载6.1 tlmgr的使用把仓库切到国内镜像TeXLive安装完不是终点宏包会有更新tlmgr就是你的包管理器。在国内使用tlmgr之前建议先把仓库地址切到国内镜像否则更新速度会非常慢甚至频繁失败。tlmgr option repository https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/tlnet然后更新tlmgr自身再更新所有宏包tlmgr update --self tlmgr update --all新装完的系统我建议先跑一遍tlmgr update --self更新包管理器本体因为安装镜像中的tlmgr可能和当前仓库的宏包索引版本不匹配直接update --all可能报错。tlmgr的几个日常命令tlmgr list --only-installed查看已安装的宏包tlmgr search --global 关键词在仓库中搜索宏包tlmgr info 宏包名查看某个宏包的版本、依赖等信息6.2 卸载TeXLive如果你确认要卸载官方提供了卸载脚本。在安装目录下找到C:\texlive\2025\tlpkg\installer\uninst.bat以管理员身份运行即可。它会清理主要的安装文件。但卸载后环境变量PATH里手动添加的项不会自动移除需要到系统环境变量里手动删掉C:\texlive\2025\bin\windows这一条。另外用户目录下可能残留C:\Users\你的用户名\AppData\Roaming\TeXLive之类的配置文件如果希望彻底清干净也可以一并删除。6.3 每年的大版本升级策略TeXLive每年发布新版本但这不意味着你必须每年都重装一次。我的习惯是正在写论文或项目时不要在大版本更新后马上升级。原因是年度版本变化偶尔会引入宏包兼容性问题而工作做到一半最怕环境出变化。建议在一个项目彻底结束后再考虑是否升级到新版本或者干脆保留旧版本继续用。TeXLive支持多版本共存你可以装新版本后把旧的编译命令路径通过编辑器配置切换不需要回退系统。一些藏在细节里的额外经验最后分享几条我实际使用中总结的经验。安装完TeXLive后如果编译中文字体发虚或者默认字体不好看可以在ctex宏包中使用\setCJKmainfont指定系统中已有的字体比如Windows自带的宋体、微软雅黑效果会好很多\documentclass[UTF8]{ctexart} \setCJKmainfont{SimSun} \begin{document} 这是宋体效果。 \end{document}如果遇到编译过程中CPU占用高但长时间不输出尤其是lualatex在某些大文档上很可能是字体缓存第一次生成导致。跑一次之后缓存建立完成后续编译就快了。还有一个比较容易踩的坑不要在OneDrive同步目录里创建LaTeX项目。OneDrive的同步机制会频繁改动文件时间戳有时候会锁住正在被编译的.aux文件导致Permission denied或File in use错误。把项目放在本地纯英文目录下最省心。关于TeXLive的安装把握住三条主线就够了下载走国内镜像安装走离线ISO装完立刻用xelatex编译中文文档验证。这三步不出问题你的环境基本就是稳定的。真正卡人的往往不是你用了哪个宏包、哪款编辑器而是在第一步源头就选错了方式和路径。先把地基打稳后面写文档、排版本才能把精力放到内容本身。