如果你第一次打开 LaTeX 的教程看到 Latex、Texlive、Texstudio 三个词八成会先愣一下到底装哪个我最早也是从“latex安装教程”一路搜到“texlive安装教程”中间还把 TeXstudio 当成了编译器。先把结论放这儿TeX Live 是底层发行版LaTeX 是你写文档时用的排版格式TeXstudio 是写代码和点编译按钮的编辑器。三者装好之后你就能在一个窗口里写中文、敲数学公式、插图片、生成 PDF。这套组合适合写论文、做简历、排长文档也适合第一次接触 LaTeX 的新手。下面我按自己踩坑的顺序把安装、配置、使用和排错全部拆开讲。1. 先把三件套的关系捋清楚1.1 LaTeX 不是软件而是一套排版语法很多人把 LaTeX 当成 Word 那样的软件其实它更像一套“用代码告诉排版引擎怎么排”的语法。你写的是纯文本里面有\documentclass、\begin{document}、\section这类命令最后由 TeX 引擎把它编译成 PDF。LaTeX 的价值在于长文档的章节编号、交叉引用、公式编号、参考文献、目录、图表标题全部可以自动维护。Word 里改一个章节标题后面几十个引用可能要手动调LaTeX 里只要重新编译编号自己会更新。我第一次写论文时最震撼的就是把\cite{}放进去参考文献格式完全不用管。LaTeX 的核心工作流是写.tex源文件调用编译器生成.pdf。中间还会产生.aux、.log、.toc、.bbl等辅助文件。新手经常看到一堆文件就慌其实这些都是自动生成的删掉也不影响源文件但有些辅助文件删掉后需要多编译几次才能恢复目录和引用。理解这一点后面看到报错就不容易懵。1.2 TeX Live 是发行版TeXstudio 是编辑器TeX Live 是 TeX 系统的一个发行版里面打包了编译器、宏包、字体工具、文档等。你可以把它理解成“LaTeX 的运行环境”。没有它TeXstudio 只是一个空壳编辑器点编译按钮会告诉你找不到xelatex或pdflatex。TeX Live 每年发布一个新版本通常用年份命名比如 TeX Live 2024、2025。它跨平台Windows、macOS、Linux 都能用。TeXstudio 是编辑器负责写代码、语法高亮、自动补全、错误提示、PDF 预览。它自己不包含编译器所以必须先装 TeX Live再装 TeXstudio。很多人问“latex连接texstudio”怎么弄其实不是连接而是让 TeXstudio 找到 TeX Live 的编译器路径。一般安装完 TeX Live 后TeXstudio 会自动检测到如果没检测到就在设置里手动指定xelatex.exe所在目录。1.3 为什么我推荐 TeX Live TeXstudio 这个组合TeX Live 的优势是宏包全、跨平台、更新方便。遇到“缺包”时一条tlmgr install就能解决不用到处找压缩包。TeXstudio 的优势是对新手友好左侧写代码右侧看 PDF报错日志能双击跳转公式和命令有自动补全。相比 VSCode LaTeX WorkshopTeXstudio 更“开箱即用”不用折腾 JSON 配置适合先把文档写起来的人。当然如果你已经重度使用 VSCode也可以后面再切到 VSCode LaTeX Workshop用latexmk做自动编译。我的建议是第一周先用 TeXstudio 把安装、中文、公式、图片、参考文献跑通等这些流程熟了再考虑换编辑器。编辑器只是外壳底层还是 TeX Live 和 LaTeX 语法换起来成本不高。注意不要先装 TeXstudio 再装 TeX Live否则 TeXstudio 首次启动找不到编译器容易以为安装失败。正确顺序是 TeX Live 在前TeXstudio 在后。2. 安装前的准备与避坑2.1 Windows 用户名是中文时先处理路径问题这是我最想提醒的一点如果你的 Windows 用户名是中文安装 TeX Live 可能会遇到莫名其妙的错误。原因是 TeX Live 的安装脚本和相关工具对非 ASCII 路径的兼容性并不完美尤其是默认安装到C:\Users\你的中文名\...时可能中途报错、宏包安装失败甚至编译时找不到文件。这不是 LaTeX 本身的问题而是路径编码带来的连锁反应。比较稳的做法有三个第一新建一个英文名的 Windows 本地账户专门用来写 LaTeX第二安装时手动把 TeX Live 装到C:\texlive\2025这类纯英文路径第三如果不想换账户至少把项目文件放在D:\latex_project这种英文目录下不要放在桌面或中文文件夹里。我见过最典型的案例是文档能编译但插入图片时一直报File not found最后发现图片路径里有中文括号和空格。另外安装路径里不要有空格。Program Files这种目录虽然 Windows 允许但 TeX Live 的某些脚本处理起来会多一层引号问题。直接装到C:\texlive最省心。安装前预留至少 10 GB 空间完整版装完加上宏包缓存占用不小。2.2 macOS 和 Linux 的安装差异macOS 用户通常下载 MacTeX它基于 TeX Live安装包比较大但装完就能用。MacTeX 默认会装到/usr/local/texlive/同时提供 TeX Live Utility 做包管理。M 系列芯片的 Mac 也不用担心MacTeX 有通用版本。安装后打开终端运行xelatex --version能看到版本信息就说明环境没问题。Linux 用户要小心很多发行版自带的texlive包版本旧、宏包不全写简单文档还行写论文很容易缺包。如果只是临时用可以apt install texlive-full但更推荐用 TeX Live 官方安装脚本装到/usr/local/texlive然后通过tlmgr管理。这样做的好处是版本新、宏包全不会和系统包管理器打架。Linux 下还要注意权限tlmgr安装宏包时可能需要sudo或者把 TeX Live 目录权限设好。2.3 下载源和安装方式怎么选TeX Live 官方提供两种常见方式在线安装器和 ISO 镜像。在线安装器体积小但下载宏包时受网络影响大ISO 镜像体积大下载一次后本地安装适合网络不稳或需要给多台机器装的情况。国内用户可以从高校镜像站下载速度通常比官方源快。安装时如果选择“完整版”它会从镜像站拉取大量宏包时间可能从二十分钟到两小时不等取决于网络和磁盘速度。我的建议是第一次装直接选完整版。虽然占空间但省去了后面缺包再补的麻烦。如果你非常在意空间可以选scheme-medium或scheme-basic之后用tlmgr install按需安装。但新手往往不知道缺什么包报错后才发现要装来回折腾更费时间。硬盘现在这么便宜给 TeX Live 留 10 GB 不算奢侈。注意安装过程中不要中途强制关闭窗口。TeX Live 安装到一半中断可能导致文件锁死或注册表残留后面重装更麻烦。如果确实要取消等它完成当前宏包写入再关。3. TeX Live 安装全过程3.1 Windows 图形化安装步骤下载好install-tl-windows.exe后右键选择“以管理员身份运行”。如果只是自己用也可以不用管理员但装到C:\texlive时需要写权限。启动后选择“Advanced”可以看到更多选项。安装根目录我一般写成C:\texlive\2025注意年份对应版本。然后选择安装方案完整版scheme-full最省心包含所有宏包和语言支持。接下来是安装源。如果在线安装选择镜像站如果下载了 ISO就挂载或解压后指向本地目录。点击“Install”后就是等待。安装过程中会滚动大量文件名不用管。安装完成后它会提示是否把 TeX Live 的bin目录加入 PATH。Windows 下最好勾选或者手动把C:\texlive\2025\bin\windows加到系统环境变量 Path 里。这样在命令行和 TeXstudio 里都能直接调用。验证安装打开 PowerShell 或 CMD输入latex --version xelatex --version tlmgr --version如果三条命令都能输出版本信息说明 TeX Live 安装成功。如果提示“不是内部或外部命令”就是 PATH 没配好。可以去环境变量里检查或者重启一下终端。安装完记得重启 TeXstudio否则它可能还读不到新的 PATH。3.2 组件选择与磁盘空间估算完整版 TeX Live 的安装体积和宏包数量有关。以近几年版本为例下载包大约几 GB安装后可能 7 到 10 GB。如果你只是写中文论文完整版绝对够用。如果空间紧张可以选scheme-medium它包含常用宏包和中文支持体积小一些。scheme-basic更小但中文、图片、参考文献相关宏包可能需要自己补。安装时还有一个选项是“安装字体和语言支持”。中文用户建议勾选尤其是ctex、xeCJK相关宏包。TeX Live 完整版已经包含这些但如果你选的是精简方案后面发现中文编译报错就要用tlmgr install ctex补装。我自己的习惯是硬盘够就完整版硬盘不够就 medium然后缺什么补什么。不要为了省几百兆去选 basic后面补包的时间更值钱。3.3 验证安装与 tlmgr 日常维护安装完成后除了看版本号还可以编译一个最小文档测试。新建test.tex\documentclass{article} \begin{document} Hello, TeX Live. \end{document}在命令行进入该目录运行pdflatex test.tex。如果生成test.pdf说明基础编译链正常。再测试中文\documentclass[UTF8]{ctexart} \begin{document} 你好TeX Live。 \end{document}用xelatex test.tex编译。能生成中文 PDF说明中文环境没问题。这里用ctexart而不是article是因为ctex宏包会处理中文字体、标点和段落缩进省去很多手动配置。tlmgr是 TeX Live 的包管理器。常用命令tlmgr update --self tlmgr update --all tlmgr install package-name tlmgr search --global --file missingfile.styupdate --self先更新自己再update --all更新所有宏包。安装缺包时用tlmgr install加包名。如果你不知道某个.sty文件属于哪个包用tlmgr search --global --file反查。这个技巧能解决很多“File xxx.sty not found”错误。注意Windows 下如果 TeX Live 装在C:\texlivetlmgr可能需要管理员权限如果提示权限不足用管理员身份打开终端。4. TeXstudio 安装与初始配置4.1 下载安装与首次启动TeXstudio 官网下载对应系统的安装包。Windows 下双击安装即可建议装到默认目录。首次启动时它会自动扫描系统里的 TeX Live。如果扫描到了下方会显示LaTeX、XeLaTeX、PdfLaTeX等命令路径。如果没扫描到就去Options - Configure TeXstudio - Commands手动把XeLaTeX、PdfLaTeX、BibTeX、Biber的路径指向 TeX Live 的bin目录。首次启动后建议先改两个设置第一把界面语言改成中文如果你需要在Options - Configure TeXstudio - General - Language里选zh_CN第二把默认编译器改成XeLaTeX在Build - Default Compiler里选。中文文档用XeLaTeX最省心因为它直接调用系统字体不像pdfLaTeX那样需要额外字体配置。4.2 配置编译器为 XeLaTeX 或 LuaLaTeXTeXstudio 默认可能用PdfLaTeX。写纯英文没问题但写中文很容易报字体错误。改法打开Options - Configure TeXstudio - Build把Default Compiler设为XeLaTeX。如果你要用biblatex还要把Default Bibliography Tool设为Biber。如果你写的是传统bibtex就保持BibTeX。这个设置很关键因为参考文献格式不对很多时候不是代码写错而是工具链选错。XeLaTeX和LuaLaTeX都支持中文区别是XeLaTeX更快、生态更成熟LuaLaTeX脚本能力更强适合复杂字体和自动化。日常论文写作我优先推荐XeLaTeX。如果你的模板明确要求LuaLaTeX那就按模板来。TeXstudio 里可以配置多个构建流程比如“XeLaTeX Biber XeLaTeX XeLaTeX”一键完成参考文献编译。4.3 给 TeXstudio 添加中文词典TeXstudio 自带拼写检查但默认没有中文词典。想让它检查中文拼写需要下载 Hunspell 格式的zh_CN.dic和zh_CN.aff放到 TeXstudio 的字典目录。Windows 下通常在C:\Users\你的用户名\AppData\Roaming\texstudio\dictionariesmacOS 在~/Library/Application Support/texstudio/dictionariesLinux 在~/.config/texstudio/dictionaries。放好后在Options - Configure TeXstudio - Language Checking里选择zh_CN重启编辑器。不过说实话中文拼写检查在 LaTeX 里效果一般因为命令、公式、英文术语混杂误报很多。我的做法是中文词典装上但只开启英文拼写检查中文靠通读。如果你写英文论文英文词典更重要。TeXstudio 默认有en_US够用。还可以自定义忽略词把LaTeX、TeXstudio、ctex这类词加进去减少红波浪线。4.4 快捷键、界面和 PDF 预览设置TeXstudio 的默认快捷键很实用F5编译F6查看 PDFF7定位到 PDF 对应位置Ctrl点击从 PDF 跳回源码。右侧 PDF 预览可以设置成内嵌也可以外置。我习惯内嵌这样改一行代码就能看到效果。如果 PDF 不更新可能是缓存问题点Recompile或删掉.aux文件再试。界面布局可以在View菜单里调整。左侧是结构树能快速跳章节、标签、参考文献下方是日志和错误列表。写长文档时结构树特别有用不用来回滚动找章节。还可以开启“自动保存”和“自动编译”但我不建议新手一开始就自动编译因为错误会频繁弹窗干扰写作。先手动F5等流程熟了再开自动。5. 第一个可编译的中文文档5.1 文档结构和 ctex 宏包一个最小中文文档长这样\documentclass[UTF8]{ctexart} \title{我的第一篇 LaTeX 文档} \author{张三} \date{\today} \begin{document} \maketitle \section{引言} 这是中文段落。LaTeX 会自动处理缩进和换行。 \section{公式} 行内公式$Emc^2$。 \end{document}这里\documentclass[UTF8]{ctexart}是关键。ctexart是基于article的中文文档类自动处理中文标题、摘要、章节格式。如果你用article加\usepackage{ctex}也可以效果类似。\title、\author、\date放在\begin{document}之前\maketitle生成标题。中文文档用XeLaTeX编译基本不会报字体错。latex换行符怎么打是高频问题。LaTeX 里段落换行靠空行源码中空一行编译后才换段。如果只想强制换行不换段用\\或\newline。但不要滥用\\否则排版会乱。数学公式里换行要用align环境不是\\随便加。还有一个技巧用~表示不换行空格比如图~1能防止“图”和“1”被分到两行。5.2 编译流程和辅助文件中文文档推荐编译链XeLaTeX - Biber - XeLaTeX - XeLaTeX。如果不用参考文献一次XeLaTeX就能出 PDF。如果有目录、交叉引用、参考文献需要多编译几次。TeXstudio 的F5默认可能只跑一次你可以在Tools - Commands里配置latexmk或者手动点Build View。我一般配置一个“快速构建”先XeLaTeX再Biber再两次XeLaTeX这样引用和目录都能更新。辅助文件的作用.aux存交叉引用和标签.toc存目录.bbl存参考文献.log存编译日志。遇到“参考文献显示问号”或“目录不更新”通常是辅助文件没跑全。解决办法不是删源码而是清理辅助文件后重新完整编译。TeXstudio 里有Tools - Clean Auxiliary Files点一下再编译很多玄学问题就没了。5.3 常用语法符号、希腊字母和数学公式LaTeX 符号大全不需要背用多了自然记住。常用的有符号LaTeX 代码说明α\alpha希腊字母β\beta希腊字母Γ\Gamma大写希腊字母∑\sum_{i1}^{n}求和∫\int_a^b积分≤\leq小于等于≥\geq大于等于≠\neq不等于×\times乘号±\pm正负号数学公式分两种行内公式用$...$比如$a^2b^2c^2$独立公式用\[...\]或equation环境\begin{equation} F G \frac{m_1 m_2}{r^2} \end{equation}equation会自动编号\[...\]不编号。多行公式用align\begin{align} a b c \\ d e f \end{align}是对齐位置\\是换行。数学公式里的希腊字母、上下标、分式、根号写熟了比 Word 公式编辑器快得多。latex数学符号和latex希腊字母不需要死记TeXstudio 有自动补全输入\alp就会提示\alpha。5.4 插入图片、表格和参考文献插入图片需要graphicx宏包\usepackage{graphicx} \begin{figure}[htbp] \centering \includegraphics[width0.8\textwidth]{figures/example.png} \caption{示例图片} \label{fig:example} \end{figure}图片路径尽量用英文不要有空格。[htbp]是位置建议LaTeX 会自动优化。引用图片用图~\ref{fig:example}。如果图片不显示先检查路径、扩展名、大小写。Windows 不区分大小写Linux 区分项目换系统时容易踩坑。表格自动换行是另一个高频需求。普通tabular不会自动换行需要用tabularx\usepackage{tabularx} \begin{table}[htbp] \centering \begin{tabularx}{\textwidth}{|X|X|X|} \hline 项目 说明 备注 \\ \hline 很长的内容 这里会自动换行 测试 \\ \hline \end{tabularx} \caption{自动换行表格} \end{table}参考文献用biblatex更方便\usepackage[backendbiber,stylenumeric]{biblatex} \addbibresource{refs.bib} ... \printbibliography然后在refs.bib里写条目用\cite{key}引用。编译时记得跑Biber。如果显示问号先检查.bib文件路径和引用键是否一致再看编译链有没有跑全。6. 常见报错与排查技巧实录6.1 编译失败时怎么定位第一个错误LaTeX 报错最烦的是“错误信息很长但真正的原因只有一个”。我的经验是打开.log文件从下往上找第一个以!开头的行。那通常才是原始错误后面的报错可能是连锁反应。TeXstudio 下方日志区可以双击错误跳到源码行但有时它会跳到错误传播的位置不是真正原因。比如少了一个$它可能报在下一段。常见错误类型Undefined control sequence通常是命令拼错或宏包没装Missing $ inserted是数学符号没放进公式环境File not found是图片或.sty文件路径不对Emergency stop往往是缺少\end{document}或括号不匹配。遇到latex不能运行时怎么知道哪个地方错误最直接的办法就是看日志第一个!再配合注释法把后面大段内容注释掉逐步缩小范围。6.2 中文乱码、字体缺失和路径问题中文乱码一般有三种原因没用XeLaTeX编译没用ctex宏包或文档类系统缺少中文字体。前两种改代码和编译器就行。第三种在 Linux 上常见需要安装中文字体比如 Noto Sans CJK。Windows 和 macOS 自带中文字体一般不会缺。如果报Font SimSun not found可以换成\setCJKmainfont{Noto Serif CJK SC}或系统里有的字体。路径问题也很常见。项目路径含中文、空格、特殊符号编译时可能报错。解决办法是把项目移到纯英文路径比如D:\latex\paper。图片文件名也不要含中文和空格。另外Windows 用户名是中文时TEXMFHOME和缓存目录可能出问题可以在环境变量里把TEXMFHOME指向英文目录。这个坑我踩过最后新建了一个英文账户才彻底解决。6.3 缺包和 tlmgr 安装技巧File xxx.sty not found是最常见的缺包错误。先用tlmgr search --global --file xxx.sty找到包名再tlmgr install 包名。比如missingfile.sty属于某个包搜索后安装即可。如果tlmgr提示数据库过期先tlmgr update --self。如果权限不足Windows 用管理员终端Linux 加sudo或调整目录权限。有些包不在 TeX Live 默认仓库里需要手动下载放到TEXMFHOME目录。新手不建议一上来就手动塞包容易版本冲突。优先用tlmgr实在找不到再手动。还有一个技巧TeX Live 完整版几乎包含常用包如果你频繁缺包可能装的是精简版考虑补装scheme-full或至少scheme-medium。6.4 图片、表格和参考文献的典型坑图片坑路径大小写、扩展名、文件名空格、图片格式。pdflatex支持 PNG、JPG、PDF不支持 EPSxelatex支持更广。表格坑列数不匹配、数量不对、\\漏写。参考文献坑编译链没跑Biber引用键拼错.bib文件没加入项目。交叉引用坑标签重复、\label放在\caption之前导致引用编号不对。常见问题速查表现象可能原因解决办法中文不显示用了 pdfLaTeX改用 XeLaTeX引用显示问号编译次数不够跑 XeLaTeXBiberXeLaTeX图片找不到路径或文件名问题改英文路径检查扩展名表格超出页面列太宽用 tabularx 或调整列宽缺 .sty 文件宏包未安装tlmgr installPDF 不更新辅助文件缓存清理 aux 后重编译注意清理辅助文件时不要删.tex、.bib、图片和.cls模板文件。只删.aux、.log、.toc、.out、.bbl、.blg这类生成文件。7. 模板、科研写作与效率提升7.1 论文模板怎么用才不出错高校和期刊模板通常包含.cls、.sty、.bst、示例.tex和说明文件。拿到模板后先读README或main.tex开头的注释确认用哪个编译器。很多中文期刊模板要求XeLaTeX比如计算机学报模板用pdfLaTeX可能字体报错。不要改.cls和.sty除非你非常清楚自己在做什么把内容写进main.tex或单独的章节文件。模板编译失败时先看它自带的示例文件能不能编译通过。如果示例都不行说明环境缺包或编译器不对。用tlmgr install补包或者换XeLaTeX。如果示例能过你的内容报错那就是你的代码问题。这个二分法能快速定位。模板里的字体、页边距、标题格式都是预设好的不要手动改否则送审格式可能出问题。7.2 版本管理和备份习惯LaTeX 项目很适合用 Git 管理。源码都是纯文本提交差异清晰。建议每次写完一节就提交一次提交信息写清楚改了什么。.gitignore里忽略.aux、.log、.toc、.synctex.gz等辅助文件但可以保留最终 PDF。这样即使改崩了也能回退到上一个可编译版本。我吃过亏改参考文献格式时把.bib弄乱幸好有 Git直接回滚。备份也很重要。除了 Git可以定期把整个项目文件夹压缩备份到网盘或移动硬盘。模板文件、图片、参考文献数据库一个都不能少。尤其是图片很多人只备份.tex换电脑后发现图片全丢了。我的习惯是项目文件夹里放figures、refs、chapters三个子目录结构清晰备份时直接打包整个文件夹。7.3 VSCode LaTeX Workshop 值不值得切换如果你已经习惯 VSCode可以装 LaTeX Workshop 插件配置latexmk编译链。优点是编辑体验统一、插件生态强、Git 集成好。缺点是要写 JSON 配置初次使用容易卡在“编译命令怎么配”。常见配置是设置latex-workshop.latex.recipes加入xelatex - biber - xelatex - xelatex的流程。配置好后保存自动编译PDF 在侧边预览体验很好。但如果你只是写论文TeXstudio 已经够用没必要为了工具而工具。VSCode 的latex workshop 网页预览pdf和本地 PDF 预览各有优劣。我的建议是先精通一套再考虑迁移。底层编译链、宏包、语法都是一样的换编辑器不会让你突然会写 LaTeX。真正提升效率的是模板、快捷键、自动补全和版本管理习惯。7.4 从 Word 到 LaTeX 的过渡技巧从 Word 转 LaTeX最痛苦的是公式和表格。Word 公式可以复制为 LaTeX但不同版本效果不一样复制后要检查上下标、分式、矩阵。word的latex无法正常显示通常是粘贴格式问题可以先用纯文本粘贴再手动修。也可以借助公式识别工具但识别结果必须逐条核对尤其是复杂公式。表格可以从 Excel 导出为 CSV再用脚本生成 LaTeX 表格比手写快。写作习惯也要调整不要一边写一边调格式。LaTeX 的正确姿势是先写内容用\section、\cite、\label组织结构最后统一编译看排版。遇到格式问题先查模板说明不要盲目改代码。我刚开始用时每写一行就编译一次效率很低。后来改成每写完一小节编译一次错误少心情也好。我现在维护论文项目的习惯是每写完一节就按一次F5看到 PDF 再继续。这个动作看起来多余但能让你在错误还很小的时候把它按死。真等到写了两千行再编译日志会教你做人。TeX Live 和 TeXstudio 的安装只是入口真正的门槛是愿意用代码思维去组织文档。一旦跨过去你会发现长文档排版原来可以这么省心。