作为一个在Mac上写了五年论文的人我太清楚这套组合拳的痛点了。身边无数同学卡在第一步兴冲冲下载了MacTeX结果编译第一份文档就报错然后百度一上午最后默默打开Word。实际上一套好用的LaTeX环境加核心语法真不用花太久关键是别把时间浪费在“环境折腾”上而是直接冲着“能把论文写出来”这个目标去。下面这份笔记就是我从零开始用Mac做LaTeX论文排版的全过程记录既有3天速成的核心语法清单也有5天实战里踩过的坑和最后的解决方案整个过程下来你也能做到。1. Mac环境准备这一步做对了后面全是省心模式1.1 发行版选择MacTeX和BasicTeX怎么选Mac上装LaTeX绕不开MacTeX和BasicTeX这两个发行版。很多人一上来就被网上的教程搞晕其实这俩的区别特别朴素MacTeX是全家桶体积四个多G自带编辑器、字体、宏包管理器和一大堆工具装完基本上“啥都有”BasicTeX是个迷你版体积不到两百兆只保留最核心的编译引擎缺的东西你后面得自己一个一个补。我给你的建议非常直接新手选MacTeX别纠结那四个G的硬盘空间。为什么因为BasicTeX虽然轻但你在论文排版中会遇到的大部分宏包都没有预装。等你用的时候发现缺宏包还得打开终端敲tlmgr install命令一个个装光是搞明白缺哪个宏包、怎么装、装完怎么刷新路径就够你折腾一晚上。而MacTeX自带的是完整版论文常用宏包基本都预装好了直接就能开干。下载MacTeX时要注意一个细节如果你用的是Apple Silicon芯片M1/M2/M3官方安装包默认是通用架构的安装过程会自动处理你不需要手动区分芯片版本。但装完以后如果你发现某些命令行工具报错提示架构不兼容通常是因为用Rosetta转译的终端去执行了arm64版本的二进制文件这个坑先记着后面的实战环节我会细说。1.2 编辑器选型VSCode加LaTeX Workshop这条路线最稳Mac上能写LaTeX的编辑器很多TeXShop是MacTeX自带的Sublime Text、Emacs、Vim也都能配但我要先帮你排除一个选项别花大量时间在选编辑器上直接用VSCode加LaTeX Workshop插件。TeXShop的界面比较老旧实时编译体验一般而且和现代工作流里的“正向/反向搜索、多文件项目管理”配合得不如VSCode顺手。VSCode免费、跨平台、插件生态好LaTeX Workshop这个插件的自动编译体验做得相当成熟是我见过对新手最友好的一套方案。安装流程很简单先去VSCode官网下载安装包装好在扩展商店里搜“LaTeX Workshop”安装然后按下Cmd ,打开设置找到settings.json往里面填这一段配置{ latex-workshop.latex.tools: [ { name: xelatex, command: xelatex, args: [ -synctex1, -interactionnonstopmode, -file-line-error, -pdf, %DOC% ] }, { name: latexmk, command: latexmk, args: [ -xelatex, -synctex1, -interactionnonstopmode, -file-line-error, %DOC% ] } ], latex-workshop.latex.recipes: [ { name: XeLaTeX, tools: [xelatex] }, { name: latexmk, tools: [latexmk] } ], latex-workshop.view.pdf.viewer: tab, latex-workshop.latex.autoBuild.run: onSave, latex-workshop.synctex.afterBuild.enabled: true }这段配置的核心动作是保存文件后自动用XeLaTeX编译PDF在右侧标签页内预览编译完成后自动定位到光标所在位置对应的PDF位置。这里的latexmk工具其实是更高级的编译方案它能自动判断需要编译几遍、自动处理参考文献索引后期写长论文会用到。“recipes”字段里你把XeLaTeX放在第一位作为默认方案后面用到参考文献时再切到latexmk。1.3 验证环境第一份能编译出来的PDF才算数环境装完别急着学语法先做一个最小验证。新建一个文件夹里面放一个test.tex文件写入这些内容\documentclass{article} \begin{document} Hello, macOS LaTeX! \end{document}然后打开VSCode的命令面板Cmd Shift P输入“Build LaTeX project”选择刚才的latexmk方案等几秒右侧应该会出现一个写着“Hello, macOS LaTeX!”的PDF窗口。如果这一步报错90%是路径问题。你打开终端依次执行which xelatex和which latexmk如果提示找不到命令说明你的PATH环境变量里没有MacTeX的bin目录。这时需要把这一行加进你的~/.zshrc文件export PATH/usr/local/texlive/2024/bin/universal-darwin:$PATH注意这里“2024”要替换成你安装的实际版本号年份目录在/usr/local/texlive/下面可以看见。加完以后执行source ~/.zshrc重新加载配置再验证一次which xelatex能输出路径就说明环境通了。这个最小验证过程的重要性怎么强调都不过分——很多人的LaTeX学习热情就是死在第一步的环境报错上而这其实只是一个路径配置问题。2. 速成阶段的核心先学20%的语法去应对80%的排版需求2.1 搞懂LaTeX文档的“三段式结构”三天速成的目标不是读懂一本几百页的LaTeX教程而是让你拿到任何一个论文模板都知道从哪里下手改。LaTeX源文件的骨架其实特别简单就三层导言区、正文区、文档结束。\documentclass[a4paper,12pt]{article} % 第一行文章类型和全局字号 % ----- 导言区 ----- \usepackage[UTF8]{ctex} % 中文支持 \usepackage{graphicx} % 插图 \usepackage{amsmath} % 数学公式 \usepackage{booktabs} % 三线表 \title{我的论文标题} \author{作者} \date{\today} % ----- 正文区 ----- \begin{document} \maketitle \section{引言} 这里开始写内容。 \end{document}你初看可能会慌这怎么全是反斜杠和花括号其实规则简单到不像编程语言。以\开头的叫命令比如\section表示一级标题带花括号的叫参数比如\section{引言}就是“创建一个一级标题标题文字是‘引言’”。以\begin{...}和\end{...}包围起来的部分叫环境表示这一块区域有特殊排版规则比如\begin{document}...\end{document}就是整个文档的主体区域。带着这个理解去读任何模板你都能迅速定位到需要改的位置\documentclass管整体样式导言区的\usepackage管功能扩展正文区的\section、\subsection是各级标题\begin{figure}、\begin{table}负责图表插入。2.2 三个高频命令组标题、列表、交叉引用速成阶段最值得先掌握的命令组就那么几个。标题层级是\section、\subsection、\subsubsection论文的章节结构基本就靠这三个。列表分两种无序列表用itemize环境有序列表用enumerate环境每一项用\item开头\begin{itemize} \item 第一个要点 \item 第二个要点 \end{itemize}交叉引用这个东西建议早点养成习惯。写论文时经常要写“如图3所示”“见表2”如果你手动敲数字后面插入一张新图、删除一个表格所有编号全乱。正确做法是给图表或公式打标签然后在正文引用\begin{figure} \centering \includegraphics[width0.8\textwidth]{figure.png} \caption{实验结果对比} \label{fig:result} \end{figure} 如图\ref{fig:result}所示实验效果良好。这样不管图的位置怎么变编号都是自动计算的。我最开始偷懒不用\label后来论文改了三次图表顺序每次都在全文里搜“如图3所示”改成“如图5所示”改到怀疑人生。这个习惯一定在速成阶段就建立后面能省大量时间。2.3 模板改不动时先定位再动手拿到学校的毕业论文模板很多人第一反应是“怎么全是报错”。这里有个特别实用的思路模板不是你写的别从上到下全读懂找到你需要改的位置只动那几处。模板一般会拆成多个文件主文件叫main.tex其他文件用\input{章节名}或\include{章节名}引入。你打开main.tex看看里面\input了哪些文件单个章节的内容去对应文件里改不要在主文件里乱动。模板里有些重型的宏包配置、封面命令、页眉页脚设置属于一改就崩的高危区——先标记出来别动它们等实战时间长了自然能理解。速成三天目标不是写出一篇完整论文而是做到“在模板上正确修改内容并成功编译”。达到这个目标你对LaTeX的掌控感就建立起来了后面5天实战才有着力点。3. 实战阶段绕不开的四道坎插图、表格、公式、参考文献3.1 插图路径、格式、大小控制的完整解法论文里插图频率极高但新手最常见的报错是“File not found”和“Unknown graphics extension”。前者是路径问题后者是格式问题。路径问题有个最省心的解法在导言区加一行\graphicspath{{figures/}}然后所有图片统一放到figures文件夹里正文写文件名即可。这样源代码里就不用写一长串路径而且多人协作、换电脑编译都不会出路径问题。格式方面写论文你基本只用考虑这三种PDF、PNG、JPG。矢量图用PDF最好放大缩小不失真位图用PNG、JPG。尽量避免在Mac上直接用PPT截图存成PNG放进论文分辨率不够时打印出来会糊。正确的做法是用width0.8\textwidth这样的参数控制图片宽度高度会自动等比缩放不容易变形。\begin{figure}[htbp] \centering \includegraphics[width0.6\linewidth]{结构示意图.pdf} \caption{系统结构示意图} \label{fig:arch} \end{figure}这里的[htbp]是LaTeX的浮动位置参数h表示here当前位置t表示页顶b表示页底p表示独立浮动页。我一般直接写成[htbp]让LaTeX自己选择最优位置这样不会在正文中留下大片空白。如果你发现图片一直“跑”到很后面的位置可以尝试[H]参数需要额外引入float宏包可以强制图片出现在代码所在位置附近但论文排版中不推荐滥用因为会破坏版面平衡。3.2 表格三线表、跨页长表格、列宽控制学术论文里的表格用三线表最规范。三线表就是只有顶线、表头下线和底线没有竖线。用booktabs宏包实现\usepackage{booktabs} \usepackage{tabularx} \usepackage{longtable} \begin{table}[htbp] \centering \caption{不同模型的性能对比} \label{tab:comparison} \begin{tabular}{lccc} \toprule 模型 准确率 召回率 F1值 \\ \midrule 模型A 88.2\% 85.1\% 86.6\% \\ 模型B 90.5\% 88.3\% 89.4\% \\ \bottomrule \end{tabular} \end{table}{lccc}这串参数定义每一列的排版方式l左对齐、c居中、r右对齐。\toprule、\midrule、\bottomrule分别是顶线、中间线和底线。表格内容太多需要跨页时用longtable宏包的环境\begin{longtable}{lccc} \caption{跨页表格标题} \\ \toprule 列1 列2 列3 \\ \midrule \endfirsthead \toprule 列1 列2 列3 \\ \midrule \endhead 数据行1 数据 数据 \\ 数据行2 数据 数据 \\ \bottomrule \end{longtable}endfirsthead和endhead是longtable特有的命令分别定义表格第一页页首和后续页页首的样式。如果你的表格列特别多、宽度超过页宽建议用tabularx环境它允许你指定表格总宽度用X列类型自动分配剩余宽度\begin{tabularx}{\textwidth}{lXXX} \toprule 指标 描述1 描述2 描述3 \\ \midrule 数值 内容 内容 内容 \\ \bottomrule \end{tabularx}3.3 公式行内公式、行间公式、多行对齐、编号控制公式是学术论文刚需好在Mac上配合LaTeX Workshop公式输入的体验比Windows上还要顺滑。行内公式用一对美元符号$...$包裹比如“设$x$为学习率”。独立的行间公式用equation环境自动编号\begin{equation} loss -\sum_{i1}^{n} y_i \log(\hat{y}_i) \label{eq:loss} \end{equation}多行公式对齐用align环境每个等号前用标记对齐点需要用amsmath宏包\begin{align} a b c \\ d e f g \end{align}每一行之间用双反斜杠\\换行。如果某一行不需要编号在这个行末加上\nonumber。文本里的数学符号输入方式很直观比如这个公式里用\hat{y}_i表示“y帽子下标i”\sum_{i1}^{n}表示从i等于1到n的求和。这些符号不是靠背是边用边查边记的建议把arXiv的“LaTeX数学符号速查表”存到书签里写公式时随手查比系统学一遍快得多。3.4 参考文献BibTeX与BibLaTeX的选择参考文献是论文排版里最不能手动的部分。手动编号、手动排序一旦增删一条文献就是灾难。正确做法是做一个.bib文件里面存所有文献然后用工具自动生成参考文献列表和引用编号。.bib文件里每一条文献长这样article{smith2020, author {Smith, John and Brown, Alice}, title {A Novel Approach to Neural Networks}, journal {Journal of Machine Learning}, year {2020}, volume {21}, pages {1--15} } inproceedings{li2021, author {Li, Wei}, title {Object Detection in Real Time}, booktitle {Proceedings of CVPR}, year {2021} }正文里用\cite{smith2020}引用编译时用bibtex或biber处理。这里有个选型问题。传统方案是BibTeX配\bibliographystyle{plain}这样的样式命令更新一点的是BibLaTeX配biblatex宏包支持的功能更多中英文混排也更友好。我的建议是看你的模板要求。学校模板已经配好BibTeX的就随模板别自己切换到BibLaTeX模板没要求的首选BibLaTeX它在参考文献中出现中文文献时的标点、顺序处理得更好。参考文献编译确实比正文麻烦因为需要编译好几遍LaTeX编译一遍产生引用信息biber或bibtex处理参考文献数据库再LaTeX编译两遍把引用编号和文献列表交叉补齐。这就是为什么前面推荐你用latexmk方案——它会自动判断这一整套流程你不用记“到底该编译几遍”这个玄学问题。4. 中文排版的关键一步XeLaTeX与字体配置4.1 为什么模板一放进中文就乱码LaTeX最初是为西文设计的对中文的支持不像Word那样开箱即用。传统编译引擎是pdfLaTeX对中文的支持需要额外加载很多底层配置非常脆弱。解决方案是用XeLaTeX引擎配合ctex宏包它调用了操作系统自身的中文字体中文支持稳定可靠。VSCode里切换到XeLaTeX的方法前面已经给了settings.json里的tools配置已经加了xelatex命令recipes里第一选项也设成了XeLaTeX。你每次用latexmk方案编译时默认会走-xelatex参数这就够了。模板如果是用pdfLaTeX写的你打开就能看到源码顶部有类似\usepackage[T1]{fontenc}、\usepackage[utf8]{inputenc}这样的老式编码配置。这些配置在XeLaTeX下不但没用还容易和ctex冲突。最佳实践是新建文档时直接用\documentclass[a4paper,12pt]{ctexart}或\documentclass{article}加\usepackage{ctex}彻底告别乱码问题。4.2 字体配置在Mac上让中文变成宋体或黑体学术论文对中文字体一般有明确要求正文宋体、标题黑体或加粗这是学校模板的硬性规定。用ctex宏包时字体配置写在\setCJKmainfont、\setCJKsansfont这几个命令里\usepackage{ctex} \setCJKmainfont{Songti SC} % 正文用宋体 \setCJKsansfont{Heiti SC} % 无衬线字体用黑体 \setCJKmonofont{STFangsong} % 等宽字体用仿宋Mac系统自带“宋体-简”“黑体-简”“楷体-简”“仿宋-简”这些中文字体直接写中文名字或英文名都可以。想查看系统里有哪些中文字体打开“字体册”应用或在终端跑一下fc-list :langzh命令Linux下也可以安装fontconfig后调用这个命令。有一个很隐蔽的坑我实战第五天才踩到Mac上的某些字体在\textbf{}加粗时如果指定的中文粗体字形不存在编译会静默失败但PDF里显示的还是普通字重完全不提示错误。这时候需要给ctex宏包指定一个真正的粗体别名\setCJKmainfont[AutoFakeBold3]{Songti SC}AutoFakeBold3的意思是加粗量是3值越大越粗。如果你发现论文里的中文标题看起来跟正文一样“不粗”优先检查是不是没有开AutoFakeBold或者模板里字重配置不对。字体配置弄好以后同一份.tex文件在Mac和Windows上编译出来的效果会略有差异因为两个系统自带的中文字体不同。如果你后续要投稿、交初稿最后阶段一定要在目标环境通常是学校实验室的电脑上编译检查一遍字体效果别等到交稿前一天才发现字体全变了。5. 实战五天总结出的四个保命习惯5.1 从现在开始用latexindent统一格式写了几天LaTeX之后你会发现总有那么几天自己看着代码都觉得乱有的段落缩进两格、有的四格长公式断行乱成一团加上注释的位置天马行空。这些问题不影响编译但影响你改稿的效率——尤其当你需要在一次修改中处理几十个section时排版乱七八糟的代码会让你崩溃。MacTeX自带了latexindent这个命令行工具它可以一键整理你的.tex文件格式。使用方法是在终端里进入你的论文目录执行latexindent -w main.tex 章节1.tex 章节2.tex-w参数表示直接原地修改文件。跑完以后每个章节缩进统一、段落间隔一致整个过程不到两秒。如果你用的是VSCodeLaTeX Workshop插件还在命令面板里提供了“Format LaTeX Project”选项不用切到终端就能执行相同的整理操作。我习惯每隔半个小时整理一次代码尤其是准备提交到Git仓库之前必须跑一遍。这样看diff的时候提交日志干净每个改动的目的一眼就能看出来。5.2 用SyncTeX在PDF与源代码之间来回定位“正向搜索”和“反向搜索”这两个词熟练使用LaTeX的人一定不陌生但对新手来说属于“不知道有这个功能所以一直没用”的隐藏技能。正向搜索在.tex文件里按住Cmd点击某一行PDF预览会自动滚到对应内容的位置。反向搜索在PDF预览里按住Cmd点击某一段文字源代码会自动跳到生成那段文字的位置。这个功能需要Synctex机制它的原理是编译时生成.synctex.gz文件记录源代码每一行与PDF页面坐标的对应关系。前面配置里已经加了-synctex1所以LaTeX Workshop的开关默认已经打开。这条习惯看起来不起眼实战中特别救命。你想想看导师在PDF批注里写“第三页第二个图下面那段话需要改”如果没有反向搜索你得全文搜关键词定位有反向搜索点一下就到来回改几十个意见也不会烦躁。5.3 编译报错了先看第一个错误我见过太多人一编译报错就慌Log文件里几百行英文错误信息一看就头皮发麻。这里分享一个特别有用的排查原则只看第一个错误忽略后面的所有“连锁报错”。LaTeX编译器有一个特点就是在一个错误之后往往会继续编译但后面的错误多半是由第一个错误引发的连锁反应并不是真正的根本原因。比如你忘了\end{document}编译器会在后面每个错误的地方都报一次“Environment document undefined”但其实根源只有一个。具体操作是编译失败后不要直接看终端乱码往下拉看Log里第一次出现!开头的行那通常才是真正的错误点。比如! Undefined control sequence. l.12 \section {引言}这个报错的意思是第12行有一个未定义的控制序列\section。你一看就明白——哦忘了加载ctex或article类里没定义这个命令。如果错的宏包就是某个\usepackage{...}检查一下名字拼写最常见的是少即多出的字母。还有一个排查大杀器注释排除法。如果编译报错且错误定位很可疑比如指向一行你明明没写内容的空行那多半是前文某个环境没有正确闭合。此时可以在报错位置后面加一行\end{document}先看看前面这部分能否编译通过。能通过说明问题在后面不能通过说明问题在前面。不断缩小范围定位问题的速度比盯着Log瞎猜快十倍。5.4 用Git管理论文版本每天一个提交别怕改坏最后一条习惯可能有点超出“LaTeX技巧”的范畴但它对写论文的帮助甚至比前面几条加起来都大从一开始就用Git管理论文的每一版改动。LaTeX的好处是纯文本天然适合使用版本控制。用Git记录每一次改动后你可以放心大胆地去改模板、调格式、删段落反正随时可以从某个历史提交中恢复。这一点对新手尤其重要——很多人不敢动模板就是因为“怕改坏了改不回来”有了Git保护这种恐惧基本消失。在Mac上初始化Git仓库很简单安装Homebrew后顺便就装了Git或者直接下载GitHub Desktop图形客户端。在论文目录里执行git init git add . git commit -m init: 初始模板之后每完成一个章节可以执行一次提交提交信息写清楚内容比如“完成第三章实验描述”或者“修改表格三的格式修复宽度溢出”。等论文写完你回头看提交日志整个写作轨迹一目了然。我在实战第一天就把导师给的模板初始化成Git仓库当时还觉得多此一举。结果第七天尝试修改页眉页脚时fancyhdr宏包配置失败整个文档跑版严重我一分钟就回滚到了之前的稳定版本。没有这个习惯的话那一次错误我可能得花一晚上去手改回来。另外如果你用Overleaf在线写作那你在本地不需要初始化仓库Overleaf自带版本历史功能。本地写就建议用Git别把“最终版”“最终版2”“真最终版”这种文件名带进工作流程那才是真正的灾难。这套从环境配置到实战习惯的流程我用了大概八天全部跑通。如果你每天能抽出三到四个小时三天速成掌握核心语法、五天实战完成一篇符合格式要求的论文主体是完全可以做到的。核心思路就一句话先让“编译-预览-修改”这个循环转起来然后在真实的论文写作需求里逐个解决问题。不要一开始就抱着教程从头啃到尾那是学生思维写论文本身才是最好的学习路径。