Mac装LaTeX只需三步:装MacTeX发行版(官网下载或Homebrew安装)、选VS Code+LaTeX Workshop或TeXStudio编辑器并设XeLaTeX为默认、用ctex宏包写中文文档验证。
mac 上装 latex 环境,核心就三件事:装好编译引擎、选对编辑器、配通中文支持。别被“tex”“xelatex”这些词吓住——现在 mactex 一键安装,vs code 或 texstudio 点几下就能用,整个过程不到二十分钟。
安装 MacTeX 发行版(推荐完整版)
MacTeX 是 macOS 最成熟、最省心的 LaTeX “全家桶”,自带 xelatex、bibtex、latexmk 和上千宏包,论文写作基本不用额外补组件。
- 官网下载:访问 tug.org/mactex,点击「MacTeX.pkg」下载(约 4–5 GB),双击运行安装向导,全程点“继续”即可
- 终端安装(需先装 Homebrew):在终端执行
brew install --cask mactex,自动完成安装与路径配置 - 安装时务必勾选「安装命令行工具」;完成后重启终端,确保
xelatex --version、bibtex --version、latexmk --version均能正常返回版本信息
选择并配置主流编辑器(VS Code 或 TeXStudio)
VS Code + LaTeX Workshop 插件轻量灵活,适合习惯现代编辑器的用户;TeXStudio 功能集成度高,开箱即用,对新手更友好。
部署和使用军舰的 macOS Automator 自动化服务集合。包含 5 个实用工作流:PDF转JPG、PNG重命名并转JPG、图像拼接、解压RAR、顺序命名图像文件。一键安装所有服务到 ~/Library/Services/ 目录。使用场景:(1) "安装我的自动化服务",(2) "部署所有 Automato...
-
VS Code 方案:安装 VS Code 后,在扩展市场搜「LaTeX Workshop」并安装;项目根目录建
.vscode/settings.json,重点配置"latex-workshop.latex.tools"使用xelatex引擎,并设"latex-workshop.latex.outDir": "%DIR%/output"分离中间文件 - TeXStudio 方案:从官网 texstudio.org 下载 dmg,拖入 Applications;首次启动需在「系统设置 → 隐私与安全性 → 辅助功能」和「完全磁盘访问」中手动授权
- 无论哪种编辑器,都建议在首选项中将默认编译器设为
XeLaTeX(而非 pdfLaTeX),这是 macOS 中文排版最稳定的选择
启用中文支持与基础验证
MacTeX 完整版已预装 ctex 宏包和常用中文字体(如 Noto Sans CJK),但需在文档中正确调用,且确保引擎匹配。
- 新建
main.tex,内容包含:\documentclass[UTF8]{ctexart}+\begin{document}你好,世界!\end{document} - 用 XeLaTeX 编译,成功生成含中文的 PDF 即表示环境跑通;若报错“字体未找到”,可临时加一行
\setmainfont{PingFang SC}指向系统字体 - 参考文献处理建议搭配
biblatex+biber(MacTeX 已内置),避免老式 BibTeX 对 UTF-8 的兼容问题
后续维护与优化建议
环境搭好不是终点,日常使用中几个小动作能显著提升效率和稳定性。
- 定期更新:终端运行
sudo tlmgr update --self --all(MacTeX)或tlmgr update --all(BasicTeX),保持宏包最新 - 空间管理:MacTeX 编译产生的
.aux、.log、.out文件默认在源码同目录,建议通过编辑器配置输出到/output子目录,避免污染项目根目录 - PDF 预览联动:VS Code 可配合
PDF.js内置预览;TeXStudio 自带 PDF 查看器,启用 SyncTeX 后支持 Ctrl+Click 跳转源码与 PDF 行号

















