2. 环境准备与安装方案选型2.1 组件选择为什么是 TeX Live TeXstudioLaTeX 不是像 Word 那样一个“安装完双击就能用”的软件它本质上是一套排版引擎加宏包集合装好之后还要配合一个编辑器来写源码、点击编译、查看 PDF。所以“装 LaTeX 环境”这件事实际要做的是两件事装一套TeX 发行版负责编译再装一个编辑器负责写代码和调用编译命令。市面上的 TeX 发行版主流就两个选择TeX Live和MiKTeX。TeX Live 的安装包更大、更全默认把几乎所有常用宏包都装好了对新手来说有一个实打实的好处你照着别人的代码敲大概率不会因为缺宏包而中途报错。MiKTeX 的优势是“按需安装”——用到什么宏包现下现装首次安装体积小但缺点是网络不好时容易卡在宏包下载上而且有些期刊和模板要求的环境MiKTeX 偶尔会在字体配置上出点小状况。既然目标是“一次配好、省心写论文”我倾向于 TeX Live。编辑器这一侧TeXstudio 是专门为 LaTeX 做的 IDE内置了结构导航、公式预览、引用交叉跳转、一键编译按钮比用 VS Code 或记事本写 LaTeX 的门槛低很多。VS Code 加 LaTeX Workshop 插件虽然也能做到类似效果但需要额外配置编译命令和片段对刚接触 LaTeX 的人来说第一次成功编译出一份 PDF 的体验很重要——TeXstudio 开箱即用度最高所以这篇教程用“TeX Live 2026 TeXstudio”这个组合。这里有一个容易忽略的认知LaTeX 环境有没有装好取决于发行版能不能被找到并执行。你装的 TeX Live 是一堆可执行文件编辑器只是负责调用它们。后面配置里一切“找不到编译器”“无法启动命令”的报错本质上都是编辑器没有找到 TeX Live 安装目录下的可执行文件这个思路先记住后面排查问题会非常有用。2.2 安装前检查Win10/Win11 系统差异与前置条件开始下载安装包之前先花五分钟确认一下你的系统状态可以省掉后面一堆莫名其妙的坑。先说系统版本。Win10 和 Win11 在安装 TeX Live、TeXstudio 这件事上几乎没有区别——它们都是 Windows NT 内核安装程序也都有对应的 Windows 版本。真正有区别的是你系统的位数32 位还是 64 位和账户权限。TeX Live 的安装程序会自动检测系统架构64 位系统装 64 位版本32 位系统装 32 位版本这个一般不用操心只要你别手动下载错安装包就行。真正要紧的是这三件事磁盘空间TeX Live 2026 完整安装大概需要 8~10 GB 空间不同年份版本略有浮动。如果你的 C 盘常年飘红安装时可以选择自定义安装目录到 D 盘或 E 盘这一点在后面的安装步骤里会重点讲。用户名路径Windows 的用户名如果是中文比如“C:\Users\张三”TeX Live 本身基本能跑但偶尔会有宏包在读写临时文件时因为路径编码问题报错。最稳妥的办法是安装到纯英文路径比如D:\texlive\2026。如果你的用户名已经是中文不建议改系统账户名容易引发权限连锁问题装到英文路径下就能规避大部分坑。杀毒软件与防火墙TeX Live 安装过程中要执行大量的批处理和 Perl 脚本操作部分杀毒软件会弹窗拦截。建议安装时暂时退出第三方杀毒软件Windows Defender 一般没太大问题装完再开启。如果安装到一半提示某个文件无法写入十有八九是杀软在捣乱。3. TeX Live 2026 下载安装全流程3.1 镜像源选哪个推荐中科大 USTC 与清华 TUNATeX Live 官方下载服务器在国外国内直连的速度只能用“随缘”来形容动辄几个小时的下载很容易把人劝退。这里推荐直接用国内镜像站速度快、稳定还支持断点续传。常用的镜像源有两个中国科学技术大学镜像站USTChttps://mirrors.ustc.edu.cn/CTAN/systems/texlive/Images/清华大学开源软件镜像站TUNAhttps://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/Images/打开镜像站的Images目录能看到两个主要文件install-tl.zip在线安装包体积很小约几 MB运行后联网从镜像站拉取安装内容。texlive2026.iso完整镜像约 4~5 GB包含全部安装内容适合一次装完整套。我的建议是如果你是第一次装直接用 ISO 镜像。原因有两个一是 ISO 里内容完整安装过程不依赖网络速度校验也更稳二是你可以在安装前用 Windows 自带的资源管理器右键“装载”ISOWin10/Win11 都原生支持双击 ISO 挂载为虚拟光驱不必刻盘也不用额外装虚拟光驱软件。在线安装包适合熟悉流程、想快速开始的人但如果半路网络断了容易卡在某个宏包上反复重试。下载前留意镜像站的版本说明TeX Live 每年发布一个新版本版本号就是年份比如 2026。镜像站通常会保留最近一两年的版本下载时认准texlive2026.iso这个文件名即可。3.2 安装过程与关键参数选择这一步是整个教程的重头戏。把 ISO 挂载好之后进入虚拟光驱目录Windows 用户会看到install-tl-windows.bat这个批处理文件。右键选择“以管理员身份运行”这一步一定要做否则后面写系统目录时会报权限错误。会弹出一个命令行窗口先是一段英文说明问你是直接安装还是自定义配置。这里不急着回车直接按下字母键c进入自定义配置界面。整个安装过程需要重点设置的地方有这么几个安装目录TEXDIR默认是C:\texlive\2026如果 C 盘空间紧张把它改成D:\texlive\2026。注意路径不要带中文和空格。Scheme 选择安装宏包集合默认是full scheme也就是完整安装。对新手强烈建议保持默认——完整安装省心省事硬盘不够再考虑medium或按需自定义但那样后面可能会出现“宏包缺失”的幺蛾子。字体目录TEXMFDIR默认跟随 TEXDIR保持默认即可。纸质文档texdoc默认会安装 PDF 版文档占空间不大但很有用遇到宏包不会用的时候可以直接在命令行敲texdoc 宏包名查看官方手册保持默认。这些参数设置完成后输入字母IInstall 的意思开始安装。接下来就是等待完整安装一般需要 20~40 分钟取决于硬盘读写速度和机器性能期间命令行窗口会滚动输出安装条目不用理会等它跑到 99% 之后出现Welcome to TeX Live字样就说明安装完成了。3.3 安装完成后如何验证安装完成之后先别急着装编辑器花一分钟确认 TeX Live 真的“能用”。按Win R输入cmd打开命令行依次输入下面几条命令tex --version xelatex --version tlmgr --version正常情况下会分别输出 TeX、XeLaTeX、tlmgr 的版本信息。如果出现不是内部或外部命令或者无法识别说明 TeX Live 的bin目录没有加入系统的 PATH 环境变量。解决方法是手动添加环境变量右键“此电脑” → 属性 → 高级系统设置 → 环境变量 → 在“系统变量”里找到Path点击编辑新建一条内容为D:\texlive\2026\bin\windows替换成你实际的安装目录。添加完后重新打开一个 cmd 窗口再试一次。还要补充一个非常实用的验证命令kpsewhich ctexart.clskpsewhich是 TeX Live 自带的宏包查找工具如果在屏幕上打印出一个.cls文件的路径说明核心宏包比如中文支持常用的ctexart已经就位。这一步对后面写中文文档非常重要——因为很多同学第一次编译中文文档报错根本原因就是没有装ctex相关宏包。4. TeXstudio 下载安装与配置4.1 下载安装与界面汉化TeXstudio 的官网是https://www.texstudio.org/下载页面的 Windows 版本是.exe安装包点击安装就行。整个安装过程没有太多需要设置的地方一直“下一步”即可安装目录路径同样建议放在纯英文路径下和 TeX Live 保持一个路数。安装完成后第一次启动界面是全英文的。如果看着费劲可以切换成中文界面菜单栏选择Options→Configure TeXstudio→ 左侧General→Language下拉框选择zh_CN点击 OK重启软件后界面就是中文了。注意一点界面汉化只是把按钮、菜单变成了中文和文档的排版语言是两回事。你在 TeXstudio 里写中文文档仍然需要后面讲的 XeLaTeX 编译方案这两件事别混淆。4.2 添加中文词典解决拼写检查和中文混排TeXstudio 自带拼写检查功能但默认只有英文词典。如果你用中文写注释或正文编辑器会把汉字全部划上红色波浪线看着非常闹心。解决办法是给 TeXstudio 安装中文拼写词典。具体操作下载中文词典文件目前比较靠谱的是 OpenOffice 的简体中文词典包zh_CN词库。下载后你会得到一堆文件包括zh_CN.aff和zh_CN.dic。把这两个文件复制到 TeXstudio 的dicts目录下。Windows 下这个目录通常在安装目录\texstudio\dicts或者在用户配置目录里。最省事的办法是直接在 TeXstudio 里看路径Options→Configure TeXstudio→General→Dictionaries下方会显示当前词典路径。把文件放进去后在编辑器右下角的语言下拉框里选择zh_CN红色波浪线就会消失。顺带提一句如果你平时写英文论文也可以用这个办法安装en_GB、en_US等词典按需切换原理一模一样。4.3 配置编译引擎XeLaTeX 与中文支持方案这是整个教程里最核心的配置没有之一。写中文 LaTeX 文档最流行的方案就是XeLaTeX ctex 宏包原因有三个XeLaTeX 原生支持 Unicode可以直接读取 UTF-8 编码的中文源文件不需要像老旧的 pdfLaTeX 那样做复杂的字符转义。XeLaTeX 可以直接调用系统中的 TrueType/OpenType 字体Windows 自带的“宋体SimSun”“黑体SimHei”“微软雅黑Microsoft YaHei”都能直接用不需要额外下载字库。ctex 宏包为中文排版做了全面支持字号、行距、标题格式、首行缩进都自动搞定不需要手写一堆自定义样式。具体配置方法在 TeXstudio 里打开Options→Configure TeXstudio→Commands选项卡找到XeLaTeX这一行确认路径指向你机器上的xelatex.exe。正常情况下如果 TeX Live 安装正确路径会自动识别为xelatex.exe -synctex1 -interactionnonstopmode %.tex确认%.tex结尾的命令格式没变就行%是 TeXstudio 的宏变量代表当前文件名。然后切到Build选项卡把“默认编译器”从PdfLaTeX改成XeLaTeX。这一步很多人会漏如果写完代码点编译后提示“无法打开 xdv 文件”或者中文变乱码八成就是默认编译器还是 pdfLaTeX。再教一个小技巧如果你经常处理中文论文可以给 TeXstudio 加一个“用 XeLaTeX 编译并查看”的快捷键。点击菜单栏选项→设置快捷键在搜索框输入“XeLaTeX”给这个命令绑定一个方便按的组合键比如F5。这样一来以后写中文文档按 F5 就能直接编译预览完全不用点鼠标。4.4 可选设置编辑器主题、字体与自动保存TeXstudio 的默认主题是白底黑字长时间写代码眼睛比较疲劳建议在Options→Configure TeXstudio→General→Theme里挑一个深色主题比如Argonaut或Gruvbox Dark选中后立即生效。编辑器字体建议选择等宽字体比如 Windows 自带的Consolas或Courier New等宽字体可以让代码对齐公式和表格源码看起来更清楚。还有一个容易被忽略但非常重要的设置Options→Configure TeXstudio→Editor选项卡找到“文件编码方式”把它设为UTF-8。Windows 下新建文件默认可能是 GBK如果文档里包含中文GBK 编码虽然本地能正常显示但一旦你用 Git 管理或用其他编辑器打开大概率乱码。统一用 UTF-8是所有写 LaTeX 的人应该养成的习惯。5. 第一个文档从空白模板到编译出 PDF5.1 最小中文文档模板环境配好之后我们直接写一个最基础的中文文档走完“新建 → 编写 → 编译 → 查看 PDF”的完整流程。打开 TeXstudio新建一个文件粘贴下面这段代码\documentclass[UTF8]{ctexart} \title{我的第一个 LaTeX 文档} \author{小明} \date{\today} \begin{document} \maketitle 你好LaTeX 这是一段测试文字用来验证中文环境是否配置成功。 \end{document}解释一下里面的关键点documentclass后面的[UTF8]告诉 ctex 宏包源文件是 UTF-8 编码ctexart是 ctex 宏包提供的中文 article 文档类它直接接管了中文排版\maketitle会根据前面的\title、\author、\date生成标题区块。这是我能想到的最简的、能体现中文排版的模板你任何一篇中文论文都可以从这个骨架开始扩展。保存文件时文件名建议用英文或无空格的命名比如first.tex然后按F5或者工具栏上的绿色播放按钮编译并预览。如果一切顺利几秒后右侧会弹出生成的 PDF——页面上有居中的标题、作者、日期还有一段中文正文字体是老宋体的风格。5.2 编译、日志与 PDF 输出位置解读按下编译按钮的那一刻TeXstudio 实际上做了两步操作首先调用xelatex命令编译.tex文件生成.pdf文件其次调用内置的 PDF 阅读器打开文档。你能在 TeXstudio 的“日志”底部窗口看到编译过程输出。如果一切正常日志最后会出现类似Output written on first.pdf (1 page, 1234 bytes).这个(1 page)表示成功生成了一页 PDF。如果编译报错日志里会有红色的!开头的错误信息这是后面排查问题的关键入口。生成的first.pdf会和你的first.tex在同一个目录下。顺带说一句编译过程中还会生成.aux、.log、.synctex.gz等辅助文件这些是排版引擎的工作文件不用管它们也不要删掉特别是.aux——下一次编译引用关系时还要用到它。5.3 图片、表格、公式与引用的基本用法环境装好了、能编译出第一份 PDF接下来就可以开始尝试写点实际内容了。这里给出三个高频功能的极简示例都是从“能跑”的角度出发先跑通再深入学。插入图片。在导言区加上\usepackage{graphicx}然后在正文里这样写\begin{figure}[htbp] \centering \includegraphics[width0.5\textwidth]{test.png} \caption{测试图片} \label{fig:test} \end{figure}这里的test.png是图片文件名图片要和.tex文件放在同一个目录width0.5\textwidth表示图片宽度占整行宽的一半这是最常用的尺寸控制方法。插入表格。最简单的三线表写法如下\begin{table}[htbp] \centering \begin{tabular}{ccc} \hline 姓名 学号 成绩 \\ \hline 张三 001 90 \\ 李四 002 85 \\ \hline \end{tabular} \caption{成绩表} \label{tab:score} \end{table}{ccc}表示三列都居中对齐\\表示换行是列分隔符\hline是画横线。插入公式。行内公式用一对美元符号包裹比如$a^2 b^2 c^2$独立成行的公式用equation环境\begin{equation} E mc^2 \label{eq:energy} \end{equation}如果你后面要引用这个公式就在正文里写如公式~\eqref{eq:energy} 所示编译后会自动变成“公式 (1)”这样的编号和跳转。文献引用是论文写作的重头戏但刚起步时不用碰 BibTeX 那么复杂的方案可以先用手动环境\begin{thebibliography}{9} \bibitem{knuth} Donald E. Knuth. \emph{The TeXbook}. Addison-Wesley, 1984. \end{thebibliography}正文里用\cite{knuth}引用编译后自动生成编号和文献列表。等以后论文量上来了再去研究 BibTeX 或 biblatex biber 的组合。6. 常见问题与排查技巧6.1 编译失败第一课从日志报错信息找线索刚开始用 LaTeX报错几乎是必然的。关键在于不要看那一堆满屏的英文就慌多数错误其实就那么几类学会看!开头的红色信息就能解决 90% 的问题。最常见的报错长这样! LaTeX Error: File ctexart.cls not found.这个信息其实非常直白找不到ctexart.cls这个文件。cls是文档类文件的后缀ctexart是文档类的名字报错说明你用了 ctex 提供的中文文档类但当前 TeX 发行版里没装 ctex 宏包。解决方法是打开命令行执行tlmgr install ctextlmgr是 TeX Live 自带的宏包管理器install 包名就是安装宏包的命令。如果你装了完整 scheme理论上所有宏包都齐了报这种错大概率是自定义安装漏了组件。顺手把tlmgr记下来以后安装任何不认识的宏包都靠它。再看另一个常见报错! Package inputenc Error: Unicode character 你 (U4F60) not set up for use with LaTeX.这个错误的意思是“你用了中文但当前编译引擎没有正确处理中文字符”。如果看到这个立即检查两件事一是源文件编码是不是 UTF-8右键文件底部状态栏可以看到或切换二是编译命令是不是 XeLaTeX大概率你还在用 pdfLaTeX 编译需要按 4.3 节的方法切换。6.2 中文乱码问题的完整解法中文乱码分两种情况现象不一样原因也不同。第一种是源文件里文字正常PDF 里显示成方块或乱码。这种情况几乎都是编译引擎的问题pdfLaTeX 不能直接排版中文解决办法是全部走 XeLaTeX 编译路径。如果你看到方块字符另一个原因是当前模板指定的中文字体在你的系统里不存在比如某模板写死了SimSun而你用的是 Mac 或 Linux 系统可以在导言区强制指定系统已有的字体例如\setCJKmainfont{Microsoft YaHei}第二种是编辑器里打开.tex文件时就是乱码。这种情况和 LaTeX 无关纯粹是文件编码与编辑器默认编码不一致。LaTeX 现在的主流标准是 UTF-8把 TeXstudio 的编辑器编码统一设为 UTF-8见 4.4 节基本就能避免。6.3 路径、文件名与权限的 Windows 专属坑Windows 下有几种很经典的报错根源都在路径上。报错一! I cant write on file xxx.aux.意思是无法写入辅助文件。原因要么是当前目录没有写权限比如直接放在桌面或放在系统保护的目录下要么是目录路径带中文导致编码失败。解决办法是把.tex文件放到一个专门的 LaTeX 工作区目录比如D:\LatexProjects路径和文件名都用纯英文。报错二Emergency stop.这是很多 Windows 新手第一次见到的最吓人的报错。这个报错几乎总是由前面的错误引发的连锁反应——要么是某个宏包文件找不到要么是路径出错导致无法创建输出文件。处理方法是回看“Emergency stop”上面几行的原始错误那里才是真正的问题所在。报错三Could not start the command: xelatex.exe -synctex1 ...这是 TeXstudio 找不到编译器的报错。解决办法是回到Options→Configure TeXstudio→Commands手动点击文件夹图标定位到 TeX Live 安装目录下的bin\windows\xelatex.exe把路径填进去即可。这条报错也印证了 1.1 节说的观点编辑器本身不会编译它只是调用外部程序。6.4 典型问题速查表把上面这些高频问题整理成表方便你以后快速对照现象原因解法File xxx.cls not found缺少文档类/宏包tlmgr install 宏包名或安装完整版 TeX Live中文在 PDF 里乱码用了 pdfLaTeX 编译切换到 XeLaTeX编辑器打开.tex乱码编码不一致统一改为 UTF-8 保存I cant write on file目录无写权限/路径带中文使用纯英文路径避免桌面目录Emergency stop前序错误连锁查看其上方原始错误解决问题后重新编译Could not start the commandTeXstudio 找不到编译器在 Commands 里手动定位xelatex.exe编译成功但 PDF 不弹出TeXstudio 内部预览器未打开点击菜单栏“查看”→“外部终端”或用系统 PDF 阅读器查看7. 一些装完环境之后值得养成的小习惯7.1 用 latexmk 代替直接点编译TeXstudio 界面上的编译按钮默认调的是 xelatex。但如果你的文档有交叉引用、目录、参考文献一次编译往往不够——第一次生成.aux第二次才能解析引用编号有些场景甚至要全套跑三遍。手动点三次编译按钮很烦用latexmk这个工具可以自动判断需要编译几遍。具体配置方法在Options→Configure TeXstudio→Commands里把PdfLaTeX或XeLaTeX那一行的命令改成latexmk -xelatex -synctex1 -interactionnonstopmode %.tex然后编译时选择对应按钮即可。latexmk 会监听文件变更自动决定编译次数以后改完代码按一次编译就能拿到最新的 PDF。7.2 用 tlmgr 保持宏包更新TeX Live 每年的发行版发布后宏包作者还会持续更新修复 bug。偶尔遇到某个宏包报错可能就是你本地的宏包版本太老升级一下就能解决。执行tlmgr update --all就能把本地所有宏包更新到镜像站最新版。注意更新前最好看一眼tlmgr --version确认它指向的是当前年份的 TeX LiveWindows 下如果装了往年版本tlmgr也会对应那个版本目录别搞混了。7.3 建立属于你自己的模板库用 LaTeX 写过几篇文章之后你会发现每次新建文档都在重复敲同样的导言区\usepackage、\title、\author……不如花点时间把自己的常用配置整理成一个模板文件保存到固定目录以后新建文档直接复制粘贴再改标题和作者就行。我的个人习惯是准备两个模板一个是纯中文的ctexart模板写笔记、报告、课程作业一个是ctexart加listings、booktabs、graphicx的“论文基础版”写正式的论文初稿。磨刀不误砍柴工这十分钟的整理能省下后面几十次重复劳动。最后再分享一个很小但很实用的技巧每次编译前先把 PDF 阅读器关掉或者使用 TeXstudio 的内部预览默认就是否则 Windows 会锁定正在使用的 PDF 文件导致编译时提示“无法写入 PDF 文件”。这个不起眼的小问题几乎每个刚接触 LaTeX 的人都会遇到记录下来能少踩一个大坑。