作为 macOS 上的老牌第三方包管理工具，MacPorts 能像 Linux 的 apt 或 yum 一样，帮我们自动解决依赖并快速安装各种开源软件。

本文将用最简练的语言，带你在 MacBook Pro 上一步到位 🚀 完成安装。

🛠️ 准备工作：安装 Xcode 命令行工具

MacPorts 依赖底层的编译环境，因此需要先安装苹果官方的命令行工具。

  1. 打开终端（Terminal）。
  2. 输入以下命令并回车：
    1
    xcode-select --install
  3. 在弹出的窗口中点击“安装”，等待下载并提示安装完成即可。

💾 第一步：下载并安装 MacPorts 官方安装包

  1. 查看系统版本：点击屏幕左上角苹果图标  -> 关于本机，确认你的 macOS 系统名称（如 macOS 10.15.8 Catalina, macOS 14 Sonoma 或 macOS 15 Sequoia）。
  2. 下载 PKG 安装包：访问 MacPorts 官方下载页面，根据你的 macOS 系统版本下载对应的 .pkg 格式安装包。
  3. 开始安装：双击运行下载好的 .pkg 引导文件，一路点击“继续”和“同意”，输入 Mac 开机密码即可完成安装。

    💡 小提示：如果安装过程最后卡在“正在运行包脚本”，这是因为它在尝试连接海外服务器进行首次同步。此时可以先断开电脑的 Wi-Fi 网络，安装程序就会直接跳过并顺畅完成。

⚙️ 第二步：配置环境变量

新版本的 MacPorts 官方安装包通常会自动帮你写入环境变量。如果不确定，可以通过以下步骤手动验证并补全。

  1. 确认你当前使用的 Shell 类型：

    1
    echo $SHELL

    (现代 MacBook Pro 默认输出一般为 /bin/zsh)

  2. 打开或创建你的 shell 配置文件（以 Zsh 为例）：

    1
    vim ~/.zshrc

  3. 在文件末尾添加以下路径：

    1
    export PATH="/opt/local/bin:/opt/local/sbin:$PATH"

  4. 保存并退出。

  5. 使配置立即生效：

    1
    source ~/.zshrc

🔄 第三步：更换国内镜像源（强烈推荐）

由于官方默认服务器在国外，直接升级会非常缓慢。建议修改为国内教育网镜像（以清华大学 TUNA 镜像源为例）。

  1. 使用管理员权限编辑 MacPorts 的源配置文件：
    1
    sudo vim /opt/local/etc/macports/sources.conf
  2. 移动到文件最底部，找到类似 rsync://rsync.macports.org/... 的这一行，在前面加上 # 注释掉它。
  3. 在它上方或下方添加清华镜像源：
    1
    rsync://mirrors.tuna.tsinghua.edu.cn/macports/release/tarballs/ports.tar [default]
  4. 保存并退出。
  5. 使用管理员权限编辑 MacPorts 的配置文件：
    1
    sudo vim /opt/local/etc/macports/macports.conf
  6. 移动到文件最底部，增加如下内容： 
    1
    rsync_server mirrors.tuna.tsinghua.edu.cn
  7. 保存并退出。

🔄 第四步：验证与首次更新

配置完成后，连接网络，运行以下命令进行首次系统诊断与本地软件库更新：

1
sudo port selfupdate

如果看到 MacPorts base is already the latest version 或者更新成功的提示，并且运行 port version 能正确输出版本号，说明你的 MacPorts 已经完美激活！

🧰 附录：MacPorts 常用高频命令

学会这几个基础指令，日常软件管理就足够了：

命令 功能
sudo port selfupdate 更新 MacPorts 自身及软件源列表
port search <软件名> 搜索你想安装的软件包
sudo port install <软件名> 安装指定软件
sudo port uninstall <软件名> 卸载指定软件
sudo port upgrade outdated 升级电脑中所有已过期的软件
port installed 查看本地电脑已经安装了哪些软件