如果你搜到这里八成是正在被毕业论文、期刊投稿或者课程报告的排版折磨。我当年写硕士论文时Word里十几张示意图的编号改一个全乱公式对齐拖了半天总差一截目录生成出来行距千奇百怪最后被同门按头安利了LaTeX。折腾完TeXlive和TeXstudio的安装配置之后回头看新手最大的门槛根本不是排版逻辑而是“装环境”和“编译出第一份PDF”这两步。这篇文章把我踩过的坑从头到尾捋一遍LaTeX、TeXlive、TeXstudio到底是什么关系安装中遇到中文系统用户名怎么处理中文排版怎么配置公式、图片、表格怎么插编译报错了又该怎么查——顺着这个顺序走完你就能正常用LaTeX写文档了。1. 先弄清三件事LaTeX不是软件TeXlive是套件TeXstudio是编辑工具很多新手把LaTeX、TeXlive、TeXstudio当成同一个东西下了半天不知道自己在装什么。这三个名词混在一起后面所有操作都会乱套。我从底层逻辑上拆一遍你理解清楚就不会再懵。1.1 TeX是排版引擎LaTeX是宏包指令集TeX最初是计算机科学家高德纳Donald Knuth在20世纪70年代末开发的一套底层排版程序它最大的特点是把“排版质量”这件事做到极致比如公式的间距、断词、连字符处理都有一套精确算法。但是直接用TeX写文档非常痛苦所有排版细节都要手动控制普通用户很难驾驭。LaTeX是Leslie Lamport在TeX之上封装的一套宏指令集相当于给引擎加了一层面向用户的“方向盘”。你只需要写\section{标题}LaTeX会帮你处理章节的编号、格式、层级关系你写\begin{equation}它就知道这是公式环境。现在你看到的绝大多数学术论文、书籍、简历底层都是TeX引擎在跑但用户真正用的语法是LaTeX。1.2 TeXlive是“全套工具箱”不是引擎本身TeXlive是LaTeX生态的发行版类似Python领域的Anaconda。它把TeX引擎、LaTeX宏包、字体、文档模板、编译工具链打包在一起装一次就能用绝大多数功能。为什么不让你单独装引擎因为LaTeX文档几乎都要依赖各种宏包比如排版中文需要ctex插入图片需要graphicx做复杂表格需要tabularx这些宏包之间有复杂的依赖关系手动下载安装会把你逼疯。TeXlive正是把这些东西全部配好装完即用。TeXlive每年发布一个新版本比如TeX Live 2024安装时可选完整方案或精简方案。完整方案体积大概7GB左右包含数千个宏包精简方案虽然装得快但后续很容易遇到“找不到某个宏包”的问题新手还是老老实实装完整方案。1.3 TeXstudio是什么角色它只是你写源码的编辑器TeXstudio的功能类似写代码用的IDE提供语法高亮、自动补全、一键编译、错误定位。它不是排版工具本身你写的.tex文件最终要交给TeXlive里的编译程序比如xelatex去编译才能得到PDF。打个比方TeX是发动机LaTeX是驾驶逻辑TeXlive是4S店给你整车配好的全套工具TeXstudio是驾驶舱仪表盘——你在驾驶舱里打方向盘发动机才会动。装完TeXlive之后其实不装TeXstudio也能写文档用记事本写.tex文件再在命令行编译也一样但效率太低。TeXstudio的存在价值就是让你少按键盘、少记命令、报错时能快速定位。2. TeXlive安装全流程从镜像站选择到解决中文用户名路径问题接下来是重头戏安装。这一步劝退了无数新手尤其是Windows用户一个“用户名是中文”就能让安装过程绕不少弯路。我把完整链路写清楚。2.1 下载TeXlive别去官网硬啃用国内镜像站TeXlive官网在国外直接下载慢且容易断。推荐用国内高校镜像站速度和稳定性都有保障。我常用清华大学的镜像源地址是https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/Images/打开后选择最新年份的目录比如texlive2024.iso或者下载Windows安装程序install-tl-windows.exe。两种方式效果一样如果下ISO可以用虚拟光驱挂载后运行安装程序如果直接下exe双击就能进入安装向导。有一点需要注意安装程序的默认配置通常没问题但“安装路径”建议手动改成纯英文路径比如D:\texlive\2024。这虽然不是绝对必须但能避免后续很多宏包路径识别问题。2.2 安装选项怎么选完整版还是精简版双击安装包后界面会显示“安装方案”默认是schemeful完整方案。新手别手欠改成精简版。原因很简单LaTeX文档依赖的宏包数量远超你的预期你写第一个文档时可能用了ctex第二天想插入代码块又要用listings再往后画流程图又需要tikz。每缺一个宏包编译就报一次“File not found”每次都去单独补装心会很累。安装时长取决于网络和硬盘速度完整版通常要花20到40分钟。这期间不要关窗口也别急着操作其他程序我遇到过安装中断导致宏包注册不完整的案例最后只能卸了重装。2.3 Windows用户名是中文提前规避这个最隐蔽的坑网上关于“Windows用户名是中文安装texlive”的求助非常多。问题根源在于TeXlive安装时会在用户目录下生成一批配置文件和缓存而某些工具链比如perl脚本、字体缓存更新程序对非ASCII字符路径支持不好中文用户名会导致这些程序无法正常读写路径甚至安装到一半就报错。如果你的Windows用户名已经是中文有三种处理方案新建一个英文用户名的Windows账户在这个新账户下安装TeXlive和TeXstudio。这是最稳妥、一劳永逸的办法。Windows设置里找到“账户→家庭和其他用户→添加用户”新账户名用拼音或英文即可以后写文档都登录这个账户。不改账户手动设置TEXMFHOME环境变量。如果你已经装了一堆软件不想换账户可以在“系统属性→高级→环境变量”里新增一个用户变量变量名TEXMFHOME值指向一个英文路径比如D:\texmf。这样LaTeX生成的个人宏包目录会优先走英文路径绕开用户名里的中文目录。装最新版TeXlive并使用管理员身份运行。新版本对中文路径的兼容性逐年变好有些机器即使不设置也能正常使用但一旦出现与路径相关的怪异报错还是要回头检查用户名。提醒一下如果已经完成安装但编译时出现“could not create temporary directory”“cannot find .texlive”之类的错误优先检查报错信息里是否包含了C:\Users\中文用户名这样的路径片段如果包含基本就是这个坑了。2.4 安装成功的验证方法装完之后别急着关窗口先验证一下。打开终端WinR输入cmd回车依次敲下面的命令tex --version pdflatex --version xelatex --version kpsewhich article.cls前三个命令能看到版本号说明引擎没问题最后一个命令会返回article.cls的完整路径比如D:/texlive/2024/texmf-dist/tex/latex/base/article.cls如果输出这个路径说明标准文档类已经注册成功。此时TeXlive安装这一步就算真正完成了。3. TeXstudio安装与配置界面、编译器、编码、中文词典缺一不可TeXstudio装起来比TeXlive快得多但配置才是重点。默认状态的TeXstudio直接编译中文文档会乱码拼写检查也不认中文。这几个配置项必须手动调。3.1 下载安装与界面语言切换TeXstudio官网是https://www.texstudio.org下载Windows版安装包一路Next即可。装好后默认是英文界面不喜欢英文的新手可以在菜单栏找到Options → Configure TeXstudio → General → Language把Language改为zh_CN重启后界面就变成中文。注意这只是界面语言切换跟“中文拼写检查”无关。很多人在这步就以为配置完中文了实际上真正涉及中文排版的是编译器选择和字体设置。3.2 关键配置编译器改为XeLaTeX编码改为UTF-8要排版中文必须先理解一个知识点现代中文LaTeX文档几乎都用XeLaTeX编译。普通LaTeX文档用pdfLaTeX编译但pdfLaTeX对中文的支持很弱需要加载额外宏包且字库适配麻烦XeLaTeX直接调用系统字体配合ctex宏包可以原生处理中文排版推荐指数五星。在TeXstudio里这样设置选项 → 设置TeXstudio → 构建 → 默认编译器在下拉列表选择XeLaTeX同时把“默认文献工具”设为BibTeX。接下来设置编码选项 → 设置TeXstudio → 编辑器 → 编辑器字体编码选UTF-8。这一点很关键如果编辑器编码不是UTF-8你写入的中文在编译时很可能变成乱码或直接报错。3.3 添加中文词典让拼写检查认识中文默认TeXstudio的拼写检查只认英文你写中文时满屏幕红波浪线非常烦人。解决办法是给TeXstudio添加中文词典。去LibreOffice的词典库或GitHub上搜索zh_CN.aff和zh_CN.dict这两个文件下载后全部放到TeXstudio安装目录下的dictionaries文件夹里比如C:\Program Files\texstudio\dictionaries。然后在TeXstudio中打开选项 → 设置TeXstudio → 编辑器 → 拼写检查把“字典”下拉选项从en_US切换为zh_CN红波浪线就会消失。有的教程会让你直接改默认语言为zh_CN但我实测过如果你连英文文档也经常写建议还是保留英文字典因为中文字典启用后对英文单词的检查会同时生效个别专业缩写可能会被误标。折中做法是保持默认只在纯中文文档里切换。3.4 第一份文档编译出第一份中文PDF配置完成后新建一个文件敲入下面这段最简代码\documentclass[UTF8]{ctexart} \begin{document} 你好世界这是一个最简单的LaTeX中文文档。 \LaTeX{} TeXlive TeXstudio三个工具凑齐了。 \end{document}保存为hello.tex注意保存路径不要带中文然后点击工具条上的“构建并查看”按钮绿色箭头。TeXstudio会调用XeLaTeX编译如果一切顺利右侧弹出的PDF预览里会显示中文段落。第一次编译通常比想象中慢因为XeLaTeX要生成字体缓存多等几秒正常。如果弹出错误先别慌看下一章节的排错思路。4. 新手高频操作实战换行、公式、希腊字母、图片、表格安装配置完成后真正的使用才刚开始。这一节聚焦搜索量最高的几个操作点换行符怎么打、数学公式和希腊字母怎么输入、图片怎么插入、表格怎么自动换行。每个点都配有可以直接抄的代码。4.1 换行符到底怎么打空行、\\与\newline的区别新手最迷惑的操作就是换行。在LaTeX里你在源码中按一次回车编译出来并不会换行甚至在正常情况下只会被当作一个空格。这是有意设计的——LaTeX把段落看成一个整体自动处理段内换行。想实现“分段”需要在两个段落之间空一行第一段文字。这里是第一段。 第二段文字。这里和第二段之间空了一行。想“强制换行但不分段”用\\或\newline这是第一行\\这是第二行用\\换行时行间距不会变化适合表格内部换行、诗歌排版等场景。想在段落之间增加一点垂直间距应该用\vspace{1em}。还有两个容易混淆的命令\par表示“结束当前段落并开始新段”效果和空行一样\linebreak则更像是“请求”LaTeX在此换行如果排版空间允许才换不允许则忽略。日常使用频率不高知道有这回事就行。4.2 数学公式入门行内公式、行间公式与希腊字母数学公式是LaTeX的主场也是绝大多数人入坑的原因。基础语法分两种场景行内公式用一对美元符号包裹比如$a^2 b^2 c^2$公式会嵌在文字段落中。行间公式用\[和\]包裹或使用equation环境公式独占一行并自动编号。勾股定理$a^2 b^2 c^2$。 \[ \cos^2\theta \sin^2\theta 1 \] \begin{equation} E mc^2 \end{equation}希腊字母用反斜杠加英文名称输入比如\alpha、\beta、\gamma大写形式首字母大写\Gamma、\Delta、\Omega。注意大小写对应的是希腊字母本身的大小写不是命令的大小写。上标用^下标用_。如果上标或下标有多个字符必须用花括号括起来e^{-x^2}而不是e^-x^2。分式用\frac{分子}{分母}根式用\sqrt{表达式}求和用\sum_{i1}^{n}积分用\int_{a}^{b}。矩阵用bmatrix环境\[ \begin{bmatrix} 1 2 3 \\ 4 5 6 \\ 7 8 9 \end{bmatrix} \]是列分隔符\\是行分隔符。担心记不住的话可以把TeXstudio的“数学”菜单里的公式模板直接插入然后填数字就行。顺带说一句网上常有人问“Word里的LaTeX公式无法正常显示怎么办”。如果你用的是Office 365或Word 2021在“插入→公式”里确实支持LaTeX语法但某个公式不显示通常是因为语法输入不完整或版本限制。这种事没必要纠结既然决定用LaTeX直接在TeXstudio里编辑渲染更标准也不用看Word脸色。4.3 插入图片graphicx宏包、路径和浮动体处理图片要先在文档导言区加载宏包\usepackage{graphicx}然后可以用\includegraphics命令插入图片\includegraphics[width0.5\textwidth]{figures/实验数据.png}width和height用于缩放常见取值包括0.5\textwidth、5cm、300px。如果只写文件名编译器会在当前工作目录、\inputpath指定的目录以及TeXlive的texmf目录里依次搜索图片。为了整洁建议把图片放在figures子目录中文件名保持英文。更规范的做法是把图片放入figure浮动体环境\begin{figure}[htbp] \centering \includegraphics[width0.6\linewidth]{figures/架构图.png} \caption{系统架构示意图} \label{fig:arch} \end{figure}这里htbp的意思是LaTeX会优先尝试放在当前位置h、页面顶部t、页面底部b实在不行放到独立一页p。新手常常困惑“为什么图片不在我想放的位置”这是LaTeX浮动体机制的正常行为目的是让排版更紧凑美观。想强制图片固定位置可以加[H]但需要额外加载float宏包\usepackage{float} \begin{figure}[H] ... \end{figure}日常工作我的建议是初稿用[htbp]让LaTeX自己排定稿时再手动调整。图片插入常见的报错有“File not found”和“Unknown graphics extension”前者多半是文件名或路径写错后者是编译器不认图片格式。XeLaTeX下优先用PNG、JPG、PDF格式的图片老旧的EPS格式在pdflatex下需要额外转换别给自己找麻烦。4.4 表格自动换行从tabular到tabularx表格是LaTeX另一位新手劝退师。最基础的表格是tabular环境\begin{tabular}{|c|c|c|} \hline 姓名 年龄 城市 \\ \hline 张三 25 北京 \\ 李四 30 上海 \\ \hline \end{tabular}{|c|c|c|}表示三列居中带竖线\hline画横线分隔列\\换行。但这个基础表格有一个严重问题如果单元格文字太长表格不会自动换行文字会溢出页面。这就是“latex表格自动换行”这个搜索词被大量搜索的原因。自动换行有两个常用解法。第一种是直接用带固定宽度的列类型比如\begin{tabular}{|p{3cm}|p{3cm}|p{3cm}|} \hline 姓名 个人简介 联系方式 \\ \hline 张三 这是一个很长很长的简介文字多到这个固定宽度的列会自动折行。 zhangsanexample.com \\ \hline \end{tabular}p{宽度}定义了一个指定宽度的段落列超出宽度会自动换行。如果想控制水平对齐可以用{\centering\arraybackslash}p{3cm}之类的写法但这需要额外加载array宏包命令略复杂。第二种是推荐新手优先使用的tabularx环境它能让表格总宽度自动适应页面宽度\usepackage{tabularx} ... \begin{tabularx}{\textwidth}{|X|X|X|} \hline 姓名 个人简介 联系方式 \\ \hline 张三 这是一个很长很长的简介文字多到这个列的宽度会自动分配。 zhangsanexample.com \\ \hline \end{tabularx}X列会自动拉伸多个X列按剩余宽度比例分配特别适合“简历项目描述”“论文对比表”这类需要占满整行宽度的场景。记住一个经验优先用tabularx加X列省去手动试宽度的折腾。5. 编译报错别慌我整理了一份新手排错知识库使用LaTeX最劝退的时刻就是点击编译后弹出一堆英文字母大写的报错信息。我见过太多人在这一步放弃。其实LaTeX的报错绝大多数是可读的掌握方法论后排查很快。5.1 从报错信息里的“!”号开始读TeXstudio编译失败后底部“消息”面板会列出错误条目条目通常以感叹号开头比如! LaTeX Error: File missing.sty not found.感叹号后面的第一行就是错误概要告诉你是哪类错误、缺失什么文件。双击错误条目左上角会定位到源码里出错的那一行。这比你在命令行里看log文件要直观得多。如果错误信息在面板里看不全或者你想看完整日志可以点击“查看日志文件”按钮TeXstudio会打开.log文件。里面内容很多新手直接搜“!”英文感叹号定位错误行即可。记住英文单词“warning”下面通常跟着的是警告不会导致编译失败真正导致失败的是“error”。5.2 高频报错对照表症状、原因、解法报错信息原因处理方法Filexxx.sty not found缺少宏包在导言区加\usepackage{xxx}或者用TeX Live Manager补装Undefined control sequence命令拼写错误或宏包没加载检查反斜杠后面的命令名确认对应的宏包已加载Missing $ inserted数学命令如\alpha用在了普通文本段落里给命令套上$...$或放入数学环境There were undefined references交叉引用的标签没找到重新编译编译两次或检查\label和\ref是否拼写一致Package inputenc Error: Unicode character ... not set up源码里有特殊字符编码不匹配确认编辑器和文档均为UTF-8编码Paragraph ended before \xxx was complete命令参数里出现了空行检查对应命令的花括号是否闭合参数内不要留空行最常见也最容易被新手误解的是“There were undefined references”这一类。它并不是你写错了什么而是LaTeX的交叉引用机制需要两次编译才能完成第一次编译收集标签信息第二次编译把引用结果写进去。在TeXstudio里最简单的方式是连续点两次“构建并查看”或者把构建命令改为latexmk它能自动判断需要编译几次。5.3 一个真实排错案例从报错到定位只花了三分钟说一个我早期帮同学排查的案例。他的文档一编译就报错! LaTeX Error: File subfigure.sty not found.第一眼看起来是缺宏包但奇怪的是他已经在导言区写了\usepackage{subfigure}。后来查了下.log文件发现错误发生在编译第二遍时也就是说TeXlive里根本找不到subfigure.sty这个文件。这个宏包是老古董了在TeXlive 2018之后被移除了。解法是换成subcaption宏包命令从\subfloat改为\begin{subfigure}即可。这个案例想说明两件事第一报错信息里的文件名不一定是你源码里的文件名可能是某个宏包内部依赖的旧宏包第二碰到报错先复制关键字去网上搜基本都能搜到前人的解法。搜的时候用英文关键词比如LaTeX File subfigure not found命中率更高。6. 从会用到熟练模板、参考文献与工具选型的进一步思考环境装好、基础语法会写了下一步就是真正投入写论文。这里给出三个方向的进阶建议也都是新手问得最多的问题。6.1 从模板开始写论文别从空文档开始造轮子期刊投稿、毕业论文都会有官方或半官方的LaTeX模板。以国内计算机领域常见的“计算机学报”为例期刊官网会提供.cls和.bst模板文件你只需要下载后放进项目目录然后用\documentclass{计算机学报模板的类名}调用。用模板最大的好处是字号、行距、标题格式、参考文献样式都已经写好了你只管填内容。找模板的优先级顺序是学校/期刊官网 → GitHub搜索模板名latex→ CTAN官方宏包库。不建议去论坛下载来历不明的模板里面可能包含了过时宏包或无效配置。遇到模板编译不过怎么办先看模板自带的使用说明很多模板明确要求用XeLaTeX或pdfLaTeX编译再确认所需要的宏包在TeXlive里都有最后如果是模板版本太旧、和最新TeXlive不兼容去GitHub看看有没有人提issue并给出了修复补丁。6.2 参考文献BibTeX带来的整理革命用Word写参考文献时手动编号、手动对齐格式让人抓狂而LaTeX的参考文献体系简直用了就回不去。第一步在项目目录建一个ref.bib文件内容按标准BibTeX格式article{knuth1978, author {Donald E. Knuth}, title {TEX: A System for Technical Text}, journal {American Mathematical Monthly}, year {1978}, volume {85}, pages {323--346} }第二步在正文中引用高德纳发明的排版系统\cite{knuth1978}改变了学术排版的传统。第三步在文档末尾\end{document}之前声明参考文献列表\bibliographystyle{plain} \bibliography{ref}最关键的一步是编译顺序XeLaTeX编译一次生成辅助文件再用BibTeX编译一次生成参考文献列表最后再用XeLaTeX编译两次生成最终的引用编号。在TeXstudio里如果你设置了“默认文献工具为BibTeX”连续点两次“构建并查看”通常就能自动完成。如果引用的编号显示为问号多半就是编译次数不够。6.3 要不要换成VS Code写LaTeX我的个人看法最近几年“VS Code LaTeX Workshop插件”的配置方案很火各大搜索平台的“vscode配置latex”关注度持续走高。VS Code确实更现代、插件生态丰富但我不建议新手直接用VS Code入门LaTeX。原因有三第一LaTeX Workshop的配置项多特别是编译工具链的配置需要理解latexmk、recipe这些概念学习成本比TeXstudio高第二VS Code的PDF预览默认用浏览器插件报错时定位到源码的跳转体验不如TeXstudio顺滑第三你需要同时维护VS Code本身的配置文件这又多了一个变量。我的建议是新手先用TeXstudio跑通整个流程等LaTeX语法熟练了、确实需要更灵活的工作流再去研究VS Code配置。到时候你用LaTeX Workshop的思路可以这样理解它本质上就是把TeXstudio的“构建并查看”命令拆成了可配置的recipe理解了这个底层逻辑配置起来就很轻松。6.4 一条实在的建议先跑通再深究从我带过的新人经验来看最容易出问题的心态是“想把所有命令都搞懂再动手”。LaTeX的命令有几万条宏包几千个你不可能全记住。正确方式是把今天的这篇文章从头到尾操作一遍装好环境编译出第一份带公式、图片、表格的中文PDF然后遇到具体问题再查具体资料。LaTeX学习曲线的陡峭主要体现在前三天跨过安装和首次编译这道坎之后你会发现自己再也回不到Word里手调图编号的日子了。
LaTeX入门到实践：TeXlive安装与TeXstudio配置完全指南
如果你搜到这里八成是正在被毕业论文、期刊投稿或者课程报告的排版折磨。我当年写硕士论文时Word里十几张示意图的编号改一个全乱公式对齐拖了半天总差一截目录生成出来行距千奇百怪最后被同门按头安利了LaTeX。折腾完TeXlive和TeXstudio的安装配置之后回头看新手最大的门槛根本不是排版逻辑而是“装环境”和“编译出第一份PDF”这两步。这篇文章把我踩过的坑从头到尾捋一遍LaTeX、TeXlive、TeXstudio到底是什么关系安装中遇到中文系统用户名怎么处理中文排版怎么配置公式、图片、表格怎么插编译报错了又该怎么查——顺着这个顺序走完你就能正常用LaTeX写文档了。1. 先弄清三件事LaTeX不是软件TeXlive是套件TeXstudio是编辑工具很多新手把LaTeX、TeXlive、TeXstudio当成同一个东西下了半天不知道自己在装什么。这三个名词混在一起后面所有操作都会乱套。我从底层逻辑上拆一遍你理解清楚就不会再懵。1.1 TeX是排版引擎LaTeX是宏包指令集TeX最初是计算机科学家高德纳Donald Knuth在20世纪70年代末开发的一套底层排版程序它最大的特点是把“排版质量”这件事做到极致比如公式的间距、断词、连字符处理都有一套精确算法。但是直接用TeX写文档非常痛苦所有排版细节都要手动控制普通用户很难驾驭。LaTeX是Leslie Lamport在TeX之上封装的一套宏指令集相当于给引擎加了一层面向用户的“方向盘”。你只需要写\section{标题}LaTeX会帮你处理章节的编号、格式、层级关系你写\begin{equation}它就知道这是公式环境。现在你看到的绝大多数学术论文、书籍、简历底层都是TeX引擎在跑但用户真正用的语法是LaTeX。1.2 TeXlive是“全套工具箱”不是引擎本身TeXlive是LaTeX生态的发行版类似Python领域的Anaconda。它把TeX引擎、LaTeX宏包、字体、文档模板、编译工具链打包在一起装一次就能用绝大多数功能。为什么不让你单独装引擎因为LaTeX文档几乎都要依赖各种宏包比如排版中文需要ctex插入图片需要graphicx做复杂表格需要tabularx这些宏包之间有复杂的依赖关系手动下载安装会把你逼疯。TeXlive正是把这些东西全部配好装完即用。TeXlive每年发布一个新版本比如TeX Live 2024安装时可选完整方案或精简方案。完整方案体积大概7GB左右包含数千个宏包精简方案虽然装得快但后续很容易遇到“找不到某个宏包”的问题新手还是老老实实装完整方案。1.3 TeXstudio是什么角色它只是你写源码的编辑器TeXstudio的功能类似写代码用的IDE提供语法高亮、自动补全、一键编译、错误定位。它不是排版工具本身你写的.tex文件最终要交给TeXlive里的编译程序比如xelatex去编译才能得到PDF。打个比方TeX是发动机LaTeX是驾驶逻辑TeXlive是4S店给你整车配好的全套工具TeXstudio是驾驶舱仪表盘——你在驾驶舱里打方向盘发动机才会动。装完TeXlive之后其实不装TeXstudio也能写文档用记事本写.tex文件再在命令行编译也一样但效率太低。TeXstudio的存在价值就是让你少按键盘、少记命令、报错时能快速定位。2. TeXlive安装全流程从镜像站选择到解决中文用户名路径问题接下来是重头戏安装。这一步劝退了无数新手尤其是Windows用户一个“用户名是中文”就能让安装过程绕不少弯路。我把完整链路写清楚。2.1 下载TeXlive别去官网硬啃用国内镜像站TeXlive官网在国外直接下载慢且容易断。推荐用国内高校镜像站速度和稳定性都有保障。我常用清华大学的镜像源地址是https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/texlive/Images/打开后选择最新年份的目录比如texlive2024.iso或者下载Windows安装程序install-tl-windows.exe。两种方式效果一样如果下ISO可以用虚拟光驱挂载后运行安装程序如果直接下exe双击就能进入安装向导。有一点需要注意安装程序的默认配置通常没问题但“安装路径”建议手动改成纯英文路径比如D:\texlive\2024。这虽然不是绝对必须但能避免后续很多宏包路径识别问题。2.2 安装选项怎么选完整版还是精简版双击安装包后界面会显示“安装方案”默认是schemeful完整方案。新手别手欠改成精简版。原因很简单LaTeX文档依赖的宏包数量远超你的预期你写第一个文档时可能用了ctex第二天想插入代码块又要用listings再往后画流程图又需要tikz。每缺一个宏包编译就报一次“File not found”每次都去单独补装心会很累。安装时长取决于网络和硬盘速度完整版通常要花20到40分钟。这期间不要关窗口也别急着操作其他程序我遇到过安装中断导致宏包注册不完整的案例最后只能卸了重装。2.3 Windows用户名是中文提前规避这个最隐蔽的坑网上关于“Windows用户名是中文安装texlive”的求助非常多。问题根源在于TeXlive安装时会在用户目录下生成一批配置文件和缓存而某些工具链比如perl脚本、字体缓存更新程序对非ASCII字符路径支持不好中文用户名会导致这些程序无法正常读写路径甚至安装到一半就报错。如果你的Windows用户名已经是中文有三种处理方案新建一个英文用户名的Windows账户在这个新账户下安装TeXlive和TeXstudio。这是最稳妥、一劳永逸的办法。Windows设置里找到“账户→家庭和其他用户→添加用户”新账户名用拼音或英文即可以后写文档都登录这个账户。不改账户手动设置TEXMFHOME环境变量。如果你已经装了一堆软件不想换账户可以在“系统属性→高级→环境变量”里新增一个用户变量变量名TEXMFHOME值指向一个英文路径比如D:\texmf。这样LaTeX生成的个人宏包目录会优先走英文路径绕开用户名里的中文目录。装最新版TeXlive并使用管理员身份运行。新版本对中文路径的兼容性逐年变好有些机器即使不设置也能正常使用但一旦出现与路径相关的怪异报错还是要回头检查用户名。提醒一下如果已经完成安装但编译时出现“could not create temporary directory”“cannot find .texlive”之类的错误优先检查报错信息里是否包含了C:\Users\中文用户名这样的路径片段如果包含基本就是这个坑了。2.4 安装成功的验证方法装完之后别急着关窗口先验证一下。打开终端WinR输入cmd回车依次敲下面的命令tex --version pdflatex --version xelatex --version kpsewhich article.cls前三个命令能看到版本号说明引擎没问题最后一个命令会返回article.cls的完整路径比如D:/texlive/2024/texmf-dist/tex/latex/base/article.cls如果输出这个路径说明标准文档类已经注册成功。此时TeXlive安装这一步就算真正完成了。3. TeXstudio安装与配置界面、编译器、编码、中文词典缺一不可TeXstudio装起来比TeXlive快得多但配置才是重点。默认状态的TeXstudio直接编译中文文档会乱码拼写检查也不认中文。这几个配置项必须手动调。3.1 下载安装与界面语言切换TeXstudio官网是https://www.texstudio.org下载Windows版安装包一路Next即可。装好后默认是英文界面不喜欢英文的新手可以在菜单栏找到Options → Configure TeXstudio → General → Language把Language改为zh_CN重启后界面就变成中文。注意这只是界面语言切换跟“中文拼写检查”无关。很多人在这步就以为配置完中文了实际上真正涉及中文排版的是编译器选择和字体设置。3.2 关键配置编译器改为XeLaTeX编码改为UTF-8要排版中文必须先理解一个知识点现代中文LaTeX文档几乎都用XeLaTeX编译。普通LaTeX文档用pdfLaTeX编译但pdfLaTeX对中文的支持很弱需要加载额外宏包且字库适配麻烦XeLaTeX直接调用系统字体配合ctex宏包可以原生处理中文排版推荐指数五星。在TeXstudio里这样设置选项 → 设置TeXstudio → 构建 → 默认编译器在下拉列表选择XeLaTeX同时把“默认文献工具”设为BibTeX。接下来设置编码选项 → 设置TeXstudio → 编辑器 → 编辑器字体编码选UTF-8。这一点很关键如果编辑器编码不是UTF-8你写入的中文在编译时很可能变成乱码或直接报错。3.3 添加中文词典让拼写检查认识中文默认TeXstudio的拼写检查只认英文你写中文时满屏幕红波浪线非常烦人。解决办法是给TeXstudio添加中文词典。去LibreOffice的词典库或GitHub上搜索zh_CN.aff和zh_CN.dict这两个文件下载后全部放到TeXstudio安装目录下的dictionaries文件夹里比如C:\Program Files\texstudio\dictionaries。然后在TeXstudio中打开选项 → 设置TeXstudio → 编辑器 → 拼写检查把“字典”下拉选项从en_US切换为zh_CN红波浪线就会消失。有的教程会让你直接改默认语言为zh_CN但我实测过如果你连英文文档也经常写建议还是保留英文字典因为中文字典启用后对英文单词的检查会同时生效个别专业缩写可能会被误标。折中做法是保持默认只在纯中文文档里切换。3.4 第一份文档编译出第一份中文PDF配置完成后新建一个文件敲入下面这段最简代码\documentclass[UTF8]{ctexart} \begin{document} 你好世界这是一个最简单的LaTeX中文文档。 \LaTeX{} TeXlive TeXstudio三个工具凑齐了。 \end{document}保存为hello.tex注意保存路径不要带中文然后点击工具条上的“构建并查看”按钮绿色箭头。TeXstudio会调用XeLaTeX编译如果一切顺利右侧弹出的PDF预览里会显示中文段落。第一次编译通常比想象中慢因为XeLaTeX要生成字体缓存多等几秒正常。如果弹出错误先别慌看下一章节的排错思路。4. 新手高频操作实战换行、公式、希腊字母、图片、表格安装配置完成后真正的使用才刚开始。这一节聚焦搜索量最高的几个操作点换行符怎么打、数学公式和希腊字母怎么输入、图片怎么插入、表格怎么自动换行。每个点都配有可以直接抄的代码。4.1 换行符到底怎么打空行、\\与\newline的区别新手最迷惑的操作就是换行。在LaTeX里你在源码中按一次回车编译出来并不会换行甚至在正常情况下只会被当作一个空格。这是有意设计的——LaTeX把段落看成一个整体自动处理段内换行。想实现“分段”需要在两个段落之间空一行第一段文字。这里是第一段。 第二段文字。这里和第二段之间空了一行。想“强制换行但不分段”用\\或\newline这是第一行\\这是第二行用\\换行时行间距不会变化适合表格内部换行、诗歌排版等场景。想在段落之间增加一点垂直间距应该用\vspace{1em}。还有两个容易混淆的命令\par表示“结束当前段落并开始新段”效果和空行一样\linebreak则更像是“请求”LaTeX在此换行如果排版空间允许才换不允许则忽略。日常使用频率不高知道有这回事就行。4.2 数学公式入门行内公式、行间公式与希腊字母数学公式是LaTeX的主场也是绝大多数人入坑的原因。基础语法分两种场景行内公式用一对美元符号包裹比如$a^2 b^2 c^2$公式会嵌在文字段落中。行间公式用\[和\]包裹或使用equation环境公式独占一行并自动编号。勾股定理$a^2 b^2 c^2$。 \[ \cos^2\theta \sin^2\theta 1 \] \begin{equation} E mc^2 \end{equation}希腊字母用反斜杠加英文名称输入比如\alpha、\beta、\gamma大写形式首字母大写\Gamma、\Delta、\Omega。注意大小写对应的是希腊字母本身的大小写不是命令的大小写。上标用^下标用_。如果上标或下标有多个字符必须用花括号括起来e^{-x^2}而不是e^-x^2。分式用\frac{分子}{分母}根式用\sqrt{表达式}求和用\sum_{i1}^{n}积分用\int_{a}^{b}。矩阵用bmatrix环境\[ \begin{bmatrix} 1 2 3 \\ 4 5 6 \\ 7 8 9 \end{bmatrix} \]是列分隔符\\是行分隔符。担心记不住的话可以把TeXstudio的“数学”菜单里的公式模板直接插入然后填数字就行。顺带说一句网上常有人问“Word里的LaTeX公式无法正常显示怎么办”。如果你用的是Office 365或Word 2021在“插入→公式”里确实支持LaTeX语法但某个公式不显示通常是因为语法输入不完整或版本限制。这种事没必要纠结既然决定用LaTeX直接在TeXstudio里编辑渲染更标准也不用看Word脸色。4.3 插入图片graphicx宏包、路径和浮动体处理图片要先在文档导言区加载宏包\usepackage{graphicx}然后可以用\includegraphics命令插入图片\includegraphics[width0.5\textwidth]{figures/实验数据.png}width和height用于缩放常见取值包括0.5\textwidth、5cm、300px。如果只写文件名编译器会在当前工作目录、\inputpath指定的目录以及TeXlive的texmf目录里依次搜索图片。为了整洁建议把图片放在figures子目录中文件名保持英文。更规范的做法是把图片放入figure浮动体环境\begin{figure}[htbp] \centering \includegraphics[width0.6\linewidth]{figures/架构图.png} \caption{系统架构示意图} \label{fig:arch} \end{figure}这里htbp的意思是LaTeX会优先尝试放在当前位置h、页面顶部t、页面底部b实在不行放到独立一页p。新手常常困惑“为什么图片不在我想放的位置”这是LaTeX浮动体机制的正常行为目的是让排版更紧凑美观。想强制图片固定位置可以加[H]但需要额外加载float宏包\usepackage{float} \begin{figure}[H] ... \end{figure}日常工作我的建议是初稿用[htbp]让LaTeX自己排定稿时再手动调整。图片插入常见的报错有“File not found”和“Unknown graphics extension”前者多半是文件名或路径写错后者是编译器不认图片格式。XeLaTeX下优先用PNG、JPG、PDF格式的图片老旧的EPS格式在pdflatex下需要额外转换别给自己找麻烦。4.4 表格自动换行从tabular到tabularx表格是LaTeX另一位新手劝退师。最基础的表格是tabular环境\begin{tabular}{|c|c|c|} \hline 姓名 年龄 城市 \\ \hline 张三 25 北京 \\ 李四 30 上海 \\ \hline \end{tabular}{|c|c|c|}表示三列居中带竖线\hline画横线分隔列\\换行。但这个基础表格有一个严重问题如果单元格文字太长表格不会自动换行文字会溢出页面。这就是“latex表格自动换行”这个搜索词被大量搜索的原因。自动换行有两个常用解法。第一种是直接用带固定宽度的列类型比如\begin{tabular}{|p{3cm}|p{3cm}|p{3cm}|} \hline 姓名 个人简介 联系方式 \\ \hline 张三 这是一个很长很长的简介文字多到这个固定宽度的列会自动折行。 zhangsanexample.com \\ \hline \end{tabular}p{宽度}定义了一个指定宽度的段落列超出宽度会自动换行。如果想控制水平对齐可以用{\centering\arraybackslash}p{3cm}之类的写法但这需要额外加载array宏包命令略复杂。第二种是推荐新手优先使用的tabularx环境它能让表格总宽度自动适应页面宽度\usepackage{tabularx} ... \begin{tabularx}{\textwidth}{|X|X|X|} \hline 姓名 个人简介 联系方式 \\ \hline 张三 这是一个很长很长的简介文字多到这个列的宽度会自动分配。 zhangsanexample.com \\ \hline \end{tabularx}X列会自动拉伸多个X列按剩余宽度比例分配特别适合“简历项目描述”“论文对比表”这类需要占满整行宽度的场景。记住一个经验优先用tabularx加X列省去手动试宽度的折腾。5. 编译报错别慌我整理了一份新手排错知识库使用LaTeX最劝退的时刻就是点击编译后弹出一堆英文字母大写的报错信息。我见过太多人在这一步放弃。其实LaTeX的报错绝大多数是可读的掌握方法论后排查很快。5.1 从报错信息里的“!”号开始读TeXstudio编译失败后底部“消息”面板会列出错误条目条目通常以感叹号开头比如! LaTeX Error: File missing.sty not found.感叹号后面的第一行就是错误概要告诉你是哪类错误、缺失什么文件。双击错误条目左上角会定位到源码里出错的那一行。这比你在命令行里看log文件要直观得多。如果错误信息在面板里看不全或者你想看完整日志可以点击“查看日志文件”按钮TeXstudio会打开.log文件。里面内容很多新手直接搜“!”英文感叹号定位错误行即可。记住英文单词“warning”下面通常跟着的是警告不会导致编译失败真正导致失败的是“error”。5.2 高频报错对照表症状、原因、解法报错信息原因处理方法Filexxx.sty not found缺少宏包在导言区加\usepackage{xxx}或者用TeX Live Manager补装Undefined control sequence命令拼写错误或宏包没加载检查反斜杠后面的命令名确认对应的宏包已加载Missing $ inserted数学命令如\alpha用在了普通文本段落里给命令套上$...$或放入数学环境There were undefined references交叉引用的标签没找到重新编译编译两次或检查\label和\ref是否拼写一致Package inputenc Error: Unicode character ... not set up源码里有特殊字符编码不匹配确认编辑器和文档均为UTF-8编码Paragraph ended before \xxx was complete命令参数里出现了空行检查对应命令的花括号是否闭合参数内不要留空行最常见也最容易被新手误解的是“There were undefined references”这一类。它并不是你写错了什么而是LaTeX的交叉引用机制需要两次编译才能完成第一次编译收集标签信息第二次编译把引用结果写进去。在TeXstudio里最简单的方式是连续点两次“构建并查看”或者把构建命令改为latexmk它能自动判断需要编译几次。5.3 一个真实排错案例从报错到定位只花了三分钟说一个我早期帮同学排查的案例。他的文档一编译就报错! LaTeX Error: File subfigure.sty not found.第一眼看起来是缺宏包但奇怪的是他已经在导言区写了\usepackage{subfigure}。后来查了下.log文件发现错误发生在编译第二遍时也就是说TeXlive里根本找不到subfigure.sty这个文件。这个宏包是老古董了在TeXlive 2018之后被移除了。解法是换成subcaption宏包命令从\subfloat改为\begin{subfigure}即可。这个案例想说明两件事第一报错信息里的文件名不一定是你源码里的文件名可能是某个宏包内部依赖的旧宏包第二碰到报错先复制关键字去网上搜基本都能搜到前人的解法。搜的时候用英文关键词比如LaTeX File subfigure not found命中率更高。6. 从会用到熟练模板、参考文献与工具选型的进一步思考环境装好、基础语法会写了下一步就是真正投入写论文。这里给出三个方向的进阶建议也都是新手问得最多的问题。6.1 从模板开始写论文别从空文档开始造轮子期刊投稿、毕业论文都会有官方或半官方的LaTeX模板。以国内计算机领域常见的“计算机学报”为例期刊官网会提供.cls和.bst模板文件你只需要下载后放进项目目录然后用\documentclass{计算机学报模板的类名}调用。用模板最大的好处是字号、行距、标题格式、参考文献样式都已经写好了你只管填内容。找模板的优先级顺序是学校/期刊官网 → GitHub搜索模板名latex→ CTAN官方宏包库。不建议去论坛下载来历不明的模板里面可能包含了过时宏包或无效配置。遇到模板编译不过怎么办先看模板自带的使用说明很多模板明确要求用XeLaTeX或pdfLaTeX编译再确认所需要的宏包在TeXlive里都有最后如果是模板版本太旧、和最新TeXlive不兼容去GitHub看看有没有人提issue并给出了修复补丁。6.2 参考文献BibTeX带来的整理革命用Word写参考文献时手动编号、手动对齐格式让人抓狂而LaTeX的参考文献体系简直用了就回不去。第一步在项目目录建一个ref.bib文件内容按标准BibTeX格式article{knuth1978, author {Donald E. Knuth}, title {TEX: A System for Technical Text}, journal {American Mathematical Monthly}, year {1978}, volume {85}, pages {323--346} }第二步在正文中引用高德纳发明的排版系统\cite{knuth1978}改变了学术排版的传统。第三步在文档末尾\end{document}之前声明参考文献列表\bibliographystyle{plain} \bibliography{ref}最关键的一步是编译顺序XeLaTeX编译一次生成辅助文件再用BibTeX编译一次生成参考文献列表最后再用XeLaTeX编译两次生成最终的引用编号。在TeXstudio里如果你设置了“默认文献工具为BibTeX”连续点两次“构建并查看”通常就能自动完成。如果引用的编号显示为问号多半就是编译次数不够。6.3 要不要换成VS Code写LaTeX我的个人看法最近几年“VS Code LaTeX Workshop插件”的配置方案很火各大搜索平台的“vscode配置latex”关注度持续走高。VS Code确实更现代、插件生态丰富但我不建议新手直接用VS Code入门LaTeX。原因有三第一LaTeX Workshop的配置项多特别是编译工具链的配置需要理解latexmk、recipe这些概念学习成本比TeXstudio高第二VS Code的PDF预览默认用浏览器插件报错时定位到源码的跳转体验不如TeXstudio顺滑第三你需要同时维护VS Code本身的配置文件这又多了一个变量。我的建议是新手先用TeXstudio跑通整个流程等LaTeX语法熟练了、确实需要更灵活的工作流再去研究VS Code配置。到时候你用LaTeX Workshop的思路可以这样理解它本质上就是把TeXstudio的“构建并查看”命令拆成了可配置的recipe理解了这个底层逻辑配置起来就很轻松。6.4 一条实在的建议先跑通再深究从我带过的新人经验来看最容易出问题的心态是“想把所有命令都搞懂再动手”。LaTeX的命令有几万条宏包几千个你不可能全记住。正确方式是把今天的这篇文章从头到尾操作一遍装好环境编译出第一份带公式、图片、表格的中文PDF然后遇到具体问题再查具体资料。LaTeX学习曲线的陡峭主要体现在前三天跨过安装和首次编译这道坎之后你会发现自己再也回不到Word里手调图编号的日子了。
