macos如何安装最小latex的basictex并且安装相关依赖包（宏）

🛠工具与编程 💻编程
1

为什么要使用basictex

macOS平台提供basictex、mactex-no-gui、mactex、livetex
这些都可以通过brew install安装

从左到右越来越大
basictex大概几百mb，mactex 5g，livetex 10g

我只是零星用一下latex转换markdown到pdf，没必要装一个硕大无比的mactex，所以选择了

brew install basictex

安装basictex后如何安装latex 宏包

安装basictex后，运行的时候会缺少各种各样的.sty
比如

转换失败: Pandoc died with exitcode "43" during conversion: Error producing PDF.
! LaTeX Error: File `footnotebackref.sty' not found.

Type X to quit or <RETURN> to proceed,
or enter new name. (Default extension: sty)

Enter file name: 
! Emergency stop.
<read *> 
         
l.58 \setcounter

再比如

转换失败: Pandoc died with exitcode "43" during conversion: Error producing PDF.
! LaTeX Error: File `xeCJK.sty' not found.

Type X to quit or <RETURN> to proceed,
or enter new name. (Default extension: sty)

Enter file name: 
! Emergency stop.
<read *> 
         
l.74     \setCJKmainfont

如果你不想折腾，还是老老实实装mactex吧，如果你想迎难而上，继续往下看

通过TeX Live 自带的包管理器tlmgr安装相关的latex宏包

这时候就需要使用TeX Live 自带的包管理器tlmgr（类似于apt、pip等）来安装相关的latex宏包
比如

# 这个命令需要sudo权限
sudo tlmgr update --self       #更新tlmgr
sudo tlmgr install footnotebackref #安装footnotebackref

如果tlmgr找不到相关的包怎么办？

方法一：手动下载

比如xeCJK包没找到

tlmgr install: package xeCJK not present in repository.

但是在官网有 （不知道为啥tlmgr连官网上都有的包还找不到），下载下来，解压缩，放到本地相关目录

 /usr/local/texlive/basictex-2025/texmf-local/tex/latex/xecjk #注意找到你自己的basictex路径再放，别直接复制我的路径

特别注意的是texmf-local这个文件夹需要自己新建，

在 TeX Live 的安装布局中，一般会出现几个 “texmf” 树（目录树）例如：

注意安装完以后要更新一下Tex文件名数据库，这样LaTeX才能找到他们

sudo mktexlsr
# 下面这个好像也行
# sudo texhash

方法二：下载包含这个小包的大包

比如

tlmgr install: package zref-abspage not present in repository.

使用 tlmgr 安装整个 zref 包：

sudo tlmgr install zref

参考