1. 为什么论文排版首选LaTeX——以及Mac用户的特殊处境如果你已经在Mac上被Word折磨过几轮大概率会理解我为什么一开始就建议直接上LaTeX。学位论文、期刊投稿、会议报告凡是带公式、带图表编号、带严格引用格式的场景Word那种“排版全靠手工拧”的模式会把人拖垮。你可能遇到过这种情况改了一个图的尺寸整章图注全乱了参考文献手敲了几十条导师说格式不对要求重排公式稍微复杂一点Word自带的公式编辑器要么弹窗卡死要么下标对齐歪到离谱。LaTeX的逻辑完全不一样它是“内容与样式分离”你只需要写纯文本的.tex源文件用命令告诉编译器“这是一级标题、这是一张图、这是一个公式、这是引用”剩下的对齐、编号、目录、交叉引用全部由引擎自动处理。这才是论文排版该有的样子。Mac用户在这件事上有一个独特优势也有一堆特有的坑。优势在于macOS自带的中文渲染、PDF预览和终端环境都很成熟VSCode LaTeX Workshop这套组合在Mac上体验非常顺滑不会像Windows那样还要折腾MikTeX的环境变量坑则在于新手第一次装MacTeX的时候往往会遇到磁盘占用太大、Homebrew装到一半报错、VSCode内置PDF预览空白、中文字体找不到、编译命令不一致这些问题一卡就是半天。这篇笔记就是把我从“完全不懂LaTeX”到“三天搭好环境、五天完成一篇带图表公式参考文献的论文”的全过程记录下来包括我踩过的每一个坑、每一个参数的含义、每一条命令为什么这么写。这篇内容适合三类人看第一类是马上要交毕业论文但还没开始排版的同学第二类是导师或期刊要求必须用LaTeX模板的科研人员第三类纯粹是好奇“Mac上写论文究竟能多高效”的效率工具爱好者。前两类可以直接照着操作第三类看完也能对这套工具体系有个完整认识。2. 3天速成的Mac端LaTeX工具链搭建三天速成不是让你真的一天24小时硬肝而是把“装环境、配编辑器、写第一个文档、摸清编译流程”这四步压缩到三天的业余时间里。我建议的路径是第一天装MacTeX和VSCode把编译链路跑通第二天学会文档结构、标题、段落、列表、公式这些基础语法能写出一个像样的空白论文框架第三天专攻图表插入和引用以及配置好自动补全和PDF预览。2.1 核心组件选型为什么不推荐TeXShop而用VSCodeMac上装LaTeX官方发行版是MacTeX但MacTeX自带的编辑器是TeXShop说实话它更像一个“能编译的记事本”不太适合写长文档。你在TeXShop里写几百行之后就会发现代码高亮一般、自动补全弱、没有文件树找章节全靠手翻。所以我的建议是用VSCode作为前端编辑器用MacTeX作为后端编译引擎用LaTeX Workshop插件把两者串起来。这套组合的本质是“编辑器只管写代码编译器只管出PDF”。VSCode负责语法高亮、代码补全、错误提示、文件导航LaTeX Workshop负责在你按保存键的那一刻自动调用xelatex或latexmk去编译并把生成的PDF直接展示在编辑器侧边栏。这样的好处是你不用记任何命令行指令不需要切窗口所见即所得地看到源码和PDF同步更新。那为什么不用Overleaf我在速成阶段强烈建议过一遍本地环境原因有两点一是Overleaf的免费版编译超时很短长论文容易中断二是本地环境能让你真正理解“编译”这件事是怎么发生的——日志怎么看、错误怎么定位、宏包怎么装这些经验在以后写大项目时非常值钱。Overleaf适合协同和终稿校对本地环境适合学习和深度编辑。2.2 MacTeX安装流程与磁盘占用问题安装MacTeX有两个常见途径直接去官网下载pkg安装包或者用Homebrew执行brew install --cask mactex。官网pkg的好处是安装过程图形化、不容易出错Homebrew的好处是后续更新方便brew upgrade --cask mactex就能升级。我推荐新手直接用官网pkg因为Homebrew在下载大文件时偶尔会因为网络问题中途失败而MacTeX这个包体量超过4GB一旦下载中断断点续传的处理不一定友好。这里有一个非常重要的事先提示MacTeX的完整安装会占用大概5GB到6GB的磁盘空间安装前务必确认磁盘剩余空间充足。如果你装了之后发现磁盘告急也有一个轻量备选方案——BasicTeX。它是MacTeX的瘦身版只有几十MB但只包含最基础的宏包中文支持、常用宏包都要自己用tlmgr逐个安装对新手来说维护成本偏高。我的建议是速成阶段直接上完整版MacTeX虽然占空间但省去了一堆“缺宏包→现装宏包→装不上→报错”的破事。安装完成后你需要验证一下核心命令是否可用。打开终端输入which xelatex如果显示出类似/Library/TeX/texbin/xelatex的路径说明安装成功。注意这里要用的是xelatex而不是pdflatex因为xelatex对中文支持更好是中文论文排版的事实标准。2.3 VSCode LaTeX Workshop配置详解VSCode装好之后先在扩展市场搜“LaTeX Workshop”并安装这是核心插件。安装完成后还需要一项关键配置在settings.json里指定编译工具链。LaTeX Workshop默认使用pdflatex编译但中文论文必须改用xelatex这一步不配置的话你写的中文文档会编译出一堆乱码报错。以下是我使用的配置直接在VSCode命令面板Cmd Shift P搜索“Open User Settings JSON”把这段内容合并进去{ latex-workshop.latex.recipes: [ { name: xelatex, tools: [xelatex] }, { name: xelatex - bibtex - xelatex * 2, tools: [xelatex, bibtex, xelatex, xelatex] } ], latex-workshop.latex.tools: [ { name: xelatex, command: xelatex, args: [ -synctex1, -interactionnonstopmode, -file-line-error, %DOC% ] }, { name: bibtex, command: bibtex, args: [%DOCFILE%] } ] }第一个recipe“xelatex”用于日常编译第二个recipe用于需要处理参考文献的场景。-synctex1是开启源码与PDF的双向定位没有它你在PDF点一下无法跳回源码对应位置-interactionnonstopmode是让编译遇到普通错误时不停下来等待人工输入直接继续避免后台卡死%DOC%会自动替换为当前打开的tex文件路径。我在第一次配置时踩过一个坑配置文件里写错了%DOC%的变量名结果编译一直报“找不到文件”。LaTeX Workshop的变量名是区分大小写的%DOC%是全大写写成了%doc%就会出问题。另外VSCode的界面语言如果是中文settings.json的字段依然全部用英文不要手滑改成中文。配置完成之后打开一个.tex文件右侧会多出一个“TeX”侧边栏。按Cmd S保存LaTeX Workshop就会自动触发编译。编译成功后会弹出一个内置PDF预览窗口这个预览支持Cmd 点击反向定位到源码对修改文档结构非常方便。2.4 第一天验收写出第一篇可编译的中文文档环境装完不能光看不练第一天收尾之前一定要亲手写完并编译成功一篇最简单的中文文档。下面这份代码是我建议的“验收文档”如果你能顺利编译出PDF说明整套工具链已经通了。\documentclass[12pt]{ctexart} \usepackage{amsmath} \title{我的第一篇LaTeX中文论文} \author{你的名字} \date{\today} \begin{document} \maketitle \section{引言} 这是中文字体测试。LaTeX的最大优势是\textbf{内容与样式分离}。 \section{公式测试} 质能方程 $Emc^2$ 是物理学最著名的公式。 \begin{equation} \int_{-\infty}^{\infty} e^{-x^2} dx \sqrt{\pi} \end{equation} \end{document}注意第一行\documentclass[12pt]{ctexart}这里的ctexart是CTeX宏包提供的文档类专门用于中文排版。如果是纯英文文章用article就行如果是毕业论文或书籍用ctexbook。\usepackage{amsmath}是数学公式必需的宏包几乎所有涉及公式的论文都要加这一行。编译成功之后你会看到PDF里中文正常显示、公式编号居中显示、标题页自动生成。这个流程跑通之后你就有了一个可以不断扩展的“论文骨架”。3. 5天实战论文排版从框架到成文环境跑通之后真正的战斗才开始。第五天到第九天的计划是第一天搭论文框架确定章节结构和模板第二天把数学公式全部搞定第三天处理图片和表格第四天整理参考文献第五天全篇统稿、导出终版。下面我把每个环节的关键细节展开讲。3.1 论文模板的选择与改造写论文的第一步不是“新建空白文档开始敲”而是先找一个合适的模板。优秀模板的意义在于它已经把页面设置、页眉页脚、标题样式、图表编号、参考文献样式全部调好了你要做的只是往里面填内容。我在Mac上试过三条路逐个说一下体验。第一条路是直接使用各高校提供的官方LaTeX模板。大部分理工科院校的毕业论文都有公开模板一般基于ctexbook文档类你只需要替换学校名称、题目、作者姓名然后把章节正文填进去。第二条路是从Overleaf的模板库下载通用模板搜索“Chinese Thesis”或“ctex”关键词很多模板都自带样例章节和说明文档。第三条路是自己从零写\documentclass[12pt, a4paper]{ctexbook}这个最灵活但工作量大我建议只在学校没有官方模板时才选它。拿到模板之后有一个细节必须立刻检查\documentclass的选项参数。比如\documentclass[12pt, a4paper]{ctexbook}里的12pt是正文字号a4paper是纸张大小这两个参数直接影响了版式是否符合学校要求。有些模板还会要求openany让每章从任意页开始节省空白页、oneside单面打印时去掉空白页。这些参数在模板头部的注释里一般会写明改之前先确认。3.2 中文支持ctexart与字体机制的底层逻辑中文LaTeX的核心就是CTeX宏包它在macOS上会自动检测系统中的中文字体比如“宋体-简”“楷体-简”“黑体-简”然后映射到宏包的字体命令。你不需要手动指定字体文件路径只需要在调用ctexart或ctexbook时按需设置中文字体族。举几个常用场景。如果你想设置全文正文字体为宋体标题为黑体可以在导言区加\setCJKmainfont{Songti SC} \setCJKsansfont{Heiti SC} \setCJKmonofont{STFangsong}这里的Songti SC是macOS自带的宋体Heiti SC是黑体STFangsong是仿宋。如果你在编译时提示“font-not-found”之类的错误大概率是系统里没有对应字体名。可以在Mac的“字体册”应用里搜索确认一下准确名称或者改用系统肯定会带的中文字体。还有一个常见需求是中英文混排时中文与英文之间的间距。LaTeX默认不会自动在中英文之间插入空格写出来会显得很挤。解决办法是加载xeCJK宏包ctexart默认已经加载它会自动处理中英文间距不需要手动加\或~。3.3 数学公式从行内公式到多行对齐论文中公式是重头戏只要你是理工科这一部分的熟练度会直接影响写作效率。我总结了一个速成记忆法行内公式用一对美元符号包裹独行公式用equation环境需要编号就自动编号不需要编号就加星号equation*多行公式用align环境。初学者经常分不清$...$和\[...\]的区别。$Emc^2$会出现在正文的同一行里适合简短公式\[...\]会另起一行居中显示适合强调公式。带编号的整行公式要放进equation环境比如\begin{equation} \nabla \cdot \mathbf{E} \frac{\rho}{\varepsilon_0} \end{equation}而多行对齐公式用align环境每行用指定对齐位置用\\换行。这个符号很容易被忽略但它是整个对齐的关键。写公式时还有一个高频痛点希腊字母和特殊符号记不住。我给你一个“够用清单”\alpha、\beta、\gamma、\delta、\epsilon、\theta、\lambda、\mu、\pi、\sigma、\omega是论文中最常见的希腊字母\le和\ge是不等号\times和\div是乘除号\pm是正负号\infty是无穷大\partial是偏导符号\sum_{i1}^{n}和\prod_{i1}^{n}是求和与连乘。如果遇到不确定的符号我一般直接在VSCode里装一个“LaTeX Sympy Calculator”扩展或者打开“Detexify”网页手画符号就能搜出对应的LaTeX命令。3.4 图表的插入与排版实战图片和表格是论文排版里最琐碎的部分也是新手最容易翻车的地方。先说图片。LaTeX插入图片不像Word那样“拖进去就行”它需要你把图片文件放到项目目录下然后在源码里用命令引用。\begin{figure}[htbp] \centering \includegraphics[width0.8\textwidth]{figures/实验结果.png} \caption{不同方法在测试集上的效果对比} \label{fig:result} \end{figure}这里的[htbp]是浮动体位置参数四个字母分别表示“here当前位置”“top页顶”“bottom页底”“page单独一页”。我的经验是尽量写[htbp]四个字母都带上让LaTeX自己选择最优放置否则图片可能会被挤到很远的下一页造成正文里出现大段空白。width0.8\textwidth表示图片宽度占正文宽度的80%。这个比例要灵活调整一般大图用0.8到0.9小图用0.4到0.6。特别大的图可以拆成两列或者旋转页面但那属于进阶操作了。图片的宽高比要提前处理好。我吃过一个亏图片原本是截图比例是16:9直接插入后发现图片在PDF里被拉伸变形。后来养成了习惯插入前先用Mac自带的“预览”应用把图片裁剪好或者用\includegraphics[width0.8\textwidth, height5cm, keepaspectratio]限定不改变宽高比。表格方面新手最直接能上手的是tabular环境\begin{table}[htbp] \centering \caption{实验参数设置} \label{tab:params} \begin{tabular}{lcc} \toprule 参数名称 数值 单位 \\ \midrule 学习率 0.001 - \\ 批量大小 32 - \\ 训练轮数 100 epoch \\ \bottomrule \end{tabular} \end{table}{lcc}表示三列分别左对齐、居中、居中。\toprule、\midrule、\bottomrule是三条横线来自booktabs宏包比默认的\hline好看很多。如果你要处理的是三线表这套结构完全够用。如果单元格内容较长需要在单元格里手动换行用\makecell宏包的\\命令可以实现这也是很多人搜“latex表格自动换行”时会用到的小技巧。3.5 参考文献BibTeX自动管理引用参考文献如果手动一条条写在文档末尾改格式会改到崩溃。正确的做法是用BibTeX先建一个.bib文件里面用结构化格式记录所有文献然后在正文里用\cite{...}命令引用最后让编译工具链自动生成格式化好的参考文献列表。一个.bib文件里的条目长这样article{knuth1984literate, author {Knuth, Donald E.}, title {Literate Programming}, journal {The Computer Journal}, year {1984}, volume {27}, number {2}, pages {97--111} }在.tex文档末尾加上两行\bibliographystyle{plain} \bibliography{references}然后需要使用我前面配置的第二个recipe“xelatex - bibtex - xelatex * 2”编译。这里有一个几乎每个新手都会遇到的疑惑为什么第一次编译后参考文献是空的因为LaTeX引用文献是分轮处理的第一轮xelatex只扫描.tex里的\cite命令并生成.aux文件第二轮bibtex读取.aux和.bib生成.bbl文件第三轮和第四轮xelatex把.bbl内容嵌入文档并解析交叉引用。如果你只编译一次参考文献当然不会出现。我第一天没搞懂这个流程时浪费了整整一个晚上。期刊和学校的模板通常都会指定\bibliographystyle比如plain、unsrt、ieeetran、gbt7714等。中文论文常用gbt7714样式它符合国标格式。如果你的模板里没写就在导言区加一句\usepackage[super,sortcompress]{gbt7714}把上标引用和压缩编号的功能打开。4. 编译报错看不懂问题排查方法与故障清单本地写LaTeX和用Overleaf最大的区别是你不再有一个网页端的“重新编译”按钮替你处理一切编译器报错时会直接甩出一屏英文日志。刚开始看不懂很正常但掌握正确的排查思路之后大部分报错都能在几分钟内定位。4.1 错误日志怎么读三大典型错误类型LaTeX报错信息的格式大致是! LaTeX Error: File xxx.sty not found.开头有一个感叹号后面跟着错误类型和具体描述。还有一类是! Undefined control sequence.表示你打了一个不存在的命令! Package xcolor Error:表示某个宏包内部出错。第一种最典型的错误是缺少宏包。比如你写了\usepackage{amsmath}但系统里没有安装日志就会显示File amsmath.sty not found。MacTeX完整版已经内置了大部分常用宏包如果你遇到这个错误先用tlmgr search 宏包名在终端查一下再用sudo tlmgr install 宏包名安装。第二种典型错误是语法拼写问题。Undefined control sequence代表你写了一个未定义命令很可能是命令名拼错比如把\textbf写成\testbf。也可能是因为你使用了某个宏包里的命令但忘记\usepackage。这个错误排查最快的方法是看报错日志里明确指出是哪一行命令直接回到.tex对应位置修改。第三种典型错误是括号不匹配或环境未闭合。Missing $ inserted或Environment equation undefined都属此类。前者是你写了数学相关符号但忘了放进数学环境后者是你用了equation环境但没有加载amsmath宏包。这类错误日志会有一个提示符号告诉你具体在哪一行出问题跟着改就行。4.2 中文乱码与字体相关的Mac专属问题中文文档编译后出现乱码在Mac上有两种常见原因。第一种是源文件编码不对。确保.tex文件保存为UTF-8编码VSCode默认就是UTF-8但我见过有同学从.txt复制内容过来残留了GBK编码导致编译时中文全部变乱码。可以在VSCode右下角看到当前文件编码如果不是UTF-8点击并选择“Reopen with Encoding”切换。第二种是编译引擎用了pdflatex而非xelatex。pdflatex的默认编码对中文字符支持很差用xelatex编译后ctex宏包会自动调用XeCJK机制处理中文字体。如果你改了VSCode配置之后还是乱码八成是编译recipe没生效这时候在VSCode的TeX侧边栏手动选择“Build with recipe”里的xelatex再重新编译一次试试。4.3 LaTeX Workshop常见问题PDF预览空白、save时无反应VSCode配好LaTeX Workshop之后最常见的问题是按下保存键发现没有任何编译动作或者编译成功但PDF预览窗口是空白的。先说“保存无反应”。检查两步第一步看VSCode底部状态栏是否有“√”或“×”图标如果是“×”点开看编译日志第二步确认.tex文件是否被正确识别为LaTeX文档LaTeX Workshop只对扩展名为.tex的文件生效如果你的文件名是.txt或者没有扩展名插件不会触发。这个坑我见过不止一次。再说“PDF预览空白”。LaTeX Workshop默认的内置PDF预览如果显示空白通常是Synctex文件没有生成或者PDF文件被其他应用占用了。我的解决方法是直接用Skim打开预览PDFSkim支持反向定位速度和体验都比内置预览好。配置方式是在settings.json中添加{ latex-workshop.view.pdf.viewer: external, latex-workshop.view.pdf.ref.viewer: external, latex-workshop.external.viewer.command: /Applications/Skim.app/Contents/SharedSupport/displayline, latex-workshop.external.viewer.args: [ -r, %LINE%, %PDF% ] }Skim可以在官网免费下载安装后记得在“Skim - 设置 - 同步”里把PDF-TeX同步支持设为“VSCode”。配置好之后在PDF里Shift Cmd 点击就能跳回源码这个联动体验是本地LaTeX的最大优势之一。4.4 Linux和Mac都适用的“增量编译”与缓存清理技巧长论文写到后半段每次保存都重新完整编译一遍会很慢。LaTeX的机制本身就支持增量编译它运行时会生成.aux、.log、.out、.toc等辅助文件第二次编译时会读取这些文件只重新计算变动部分。所以只要你不是每次改动结构日常编辑中重复使用同一个recipe连续编译速度会明显快过首次编译。但这里有一个隐藏问题如果目录结构或图表引用发生变化软件依赖的辅助文件没有及时更新可能出现“引用编号对不上”的情况。这时候最有效的办法就是清理缓存后完整重编。手动清理太麻烦我一般直接在VSCode的TeX侧边栏点击“Clean auxiliary files”按钮或者在终端运行rm -f *.aux *.bbl *.blg *.toc *.out *.fdb_latexmk然后重新编译两遍所有引用就能彻底刷新。4.5 学术写作中的“跨平台转移”坑从Mac到Windows很多同学在学校写完回到宿舍用Windows电脑继续编辑结果发现编译报错。最常见的原因是字体不一致。你在Mac上用\setCJKmainfont{Songti SC}指定了Mac系统字体切到Windows后系统里没有这个字体编译器直接报错。解决办法是不要硬编码具体字体名而应该在.tex文件的导言区做条件判断\usepackage{ifplatform} \ifmacosx \setCJKmainfont{Songti SC} \else \setCJKmainfont{SimSun} \fiifplatform宏包需要和\usepackage[open]{ifplatform}配合使用。这么做之后同一个.tex文件在Mac和Windows上都能正确编译。当然如果是团队写作我更建议在主目录下统一一个编译环境说明文档避免各人机器配置差异带来的低级错误。5. Mac环境下LaTeX周边的效率工具与避坑指南写论文这件事不只是打开LaTeX然后闷头敲旁边还有一堆环境问题在等着你。我把Mac用户最常见的周边痛点在这里集中处理一下。5.1 Homebrew安装报错的处理思路很多Mac用户习惯用Homebrew来管理软件包但安装大型软件时经常遇到报错。常见的有curl: (7) Failed to connect to raw.githubusercontent.com port 443和Error: Checksum mismatch。前者通常是网络问题解决办法是检查代理设置或者在终端临时指定较长的超时时间重试。后者是下载的文件校验和不匹配通常是下载中断导致的清掉下载缓存后重试brew cleanup或者找到~/Library/Caches/Homebrew目录下对应的文件删掉。还有一个高频报错是Error: The following directories are not writable by your user: /usr/local这是Homebrew安装目录权限问题。在Apple Silicon芯片的Mac上Homebrew默认安装在/opt/homebrew一般不会遇到这个报错如果是Intel Mac且安装在/usr/local执行sudo chown -R $(whoami) /usr/local就能修复。这些并不是LaTeX本身的报错但却是Mac用户装MacTeX时最常见的拦路虎所以我建议遇到Homebrew问题先冷静一点多数是网络问题或者是权限问题不要急着重装系统。5.2 磁盘空间告急Mac系统数据怎么清理MacTeX完整安装占用大如果你还装了Docker、虚拟机、Xcode磁盘很快就吃紧。有人会看到“系统数据”占用几十GB就想动手清理。我的建议是系统数据里大部分是缓存和快照不能直接乱删否则可能导致系统不稳定。安全做法是打开“关于本机 - 存储空间 - 管理”优先清理“文稿”“废纸篓”“iOS文件”这几项。针对LaTeX项目.aux、.pdf、.bbl等中间文件也会堆积养成定期清理缓存文件的习惯最重要。Docker和虚拟机在论文写作期间如果实在用不到先卸载或者暂停镜像能省出不少空间。我见过有人因为磁盘满而编译失败报错信息是No space left on device这个错误一眼就能看出来但很多人没意识到是磁盘问题还以为是LaTeX配置写错。5.3 从Word和Excel迁移到LaTeX的心智转变最后聊一点心态上的东西。很多人从Word迁到LaTeX最大的不适应不是语法本身而是思维模式的反转。Word是“所见即所得”你拉一下标尺段落缩进就变了LaTeX是“所想即所得”你写代码告诉编译器“这段是正文、这段是注释”编译器负责实现。这个转变需要一两天的时间但一旦适应之后你会发现写作效率翻倍因为再也不用花时间调整格式了。有一个特别典型的例子LaTeX的换行符不是用回车键打的。很多人搜“latex换行符怎么打”其实在LaTeX里一个空行表示段落切换两个反斜杠\\表示强制换行\newline和\par也有各自用途。你脑子里不能把Word的“回车键换行”的习惯带进来否则会出现大面积不想要的断行。写到这里我实际使用的了一套“主模板 内容分章”的组织方式第一章放在chapters/intro.tex第二章放在chapters/method.tex主文件只用\include{chapters/ch01}把各章串联起来。这样写的好处是每一章的体量不至于太庞大编译时也好定位错误。我已经把这个结构模板存成了自己的固定起点每开一个新项目就复制一份配好宏包就开始写。如果你也经常写论文强烈建议花半小时维护一套自己的“速成模板”一次配置长期受益。