MacBook 使用笔记（一）：在 MacBook 上安装并配置 HomeBrew + Docker + Python

在 MacBook 上安装并配置 HomeBrew + Docker + Python

安装 HomeBrew

1 打开终端，输入以下命令，按脚本提示安装，非常简单

# 下载脚本并使用zsh运行
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

可能遇到的问题：

• 弹窗提示缺少 Git 需要安装命令行开发者工具，确认并安装完成后重新执行安装 HomeBrew 的命令即可

# 查询 Git 版本号
git --version
# >> git version 2.39.5 (Apple Git-154)

• 终端提示需要选择安装镜像，选择中科大或清华即可

• 终端提示选择 HomeBrew 的下载源，选择中科大或清华即可

• 终端提示输入密码，输入内容是不可见的，输入即可

• 终端提示是否删除其它版本 HomeBrew ，确认即可

2 安装完成后，进行确认，如果出现版本号，恭喜安装成功

# 查询 HomeBrew 版本号
brew --verison
# >> Homebrew 4.4.21

可能遇到的问题：

• 进行确认时，若提示命令不存在，则重启终端

使用 HomeBrew 的优点：

• 自动解决应用依赖问题

• 便于更新和卸载，卸载残余较少甚至没有

• 可灵活安装应用的各个版本，并且方便进行版本管理

• 安装目录统一规范

安装本地 Python

安装 Pyenv

1 打开终端，输入以下命令，非常简单

# 使用 HomeBrew 安装 Pyenv
brew install pyenv
# >> pyenv 2.5.3

2 安装完成后，配置环境变量

# 配置 Pyenv 的环境变量并初始化
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(pyenv init -)"' >> ~/.zshrc

# 重新加载 ~/.zshrc 文件，使更改立即生效
source ~/.zshrc

3 配置完成后，进行确认，如果出现版本号，恭喜安装成功

# 查询 Pyenv 版本号
pyenv --verison
# >> pyenv 2.5.3

使用 Pyenv 的优点：

• 相对于 Conda 管理器，更加轻量级

• 便于更新和卸载，卸载残余较少甚至没有

• 可灵活安装 Python 的各个版本，并且方便进行版本管理

• 安装目录统一规范

使用 Pyenv 安装 Python

1 打开终端，查看所有可以安装的 Python 版本

# 查询可安装的 Python 版本
pyenv install --list
# >> ...
     3.12.6
     3.12.7
     3.12.8
     3.12.9
     3.13.2
     ...

2 安装你需要的 Python 版本

# 安装 Python ,假设安装版本为3.13.2
pyenv install 3.13.2

可能遇到的问题：

• 终端安装成功但是警告缺失模块，安装 xz ，卸载 Python ，再重新安装 Python 即可

# 警告缺失解压缩相关包
...
ModuleNotFoundError: No module named '_lzma'
WARNING: The Python lzma extension was not compiled. Missing the lzma lib?
...

# 安装解压缩相关包
brew install xz

# 卸载已安装的 Python
pyenv uninstall 3.13.2

# 重新安装 Python
pyenv install 3.13.2

3 安装完成后，进行确认，如果出现版本号，恭喜安装成功

# 查询 Python 版本号
python --verison
# >> Python 3.13.2

# 查询 Pip 版本号
pip --version
# >> pip 24.3.1

安装容器 Python

安装 Docker

1 官网下载符合电脑版本的包

https://docker.github.net.cn/desktop/install/mac-install/

可能遇到的问题：

• MacBook m系列芯片用户选择"适用于采用 Apple 芯片的 Mac 的 Docker Desktop"安装包

2 点击"下载"文件夹中的 Docker.dmg，将左边的 Docker 图标拖动到右边的 Applications 文件夹

3 在启动台找到 Docker，点击启动

4 安装完成后，进行确认，如果出现版本号，恭喜安装成功

# 查询 Docker 版本号
docker --verison
# >> Docker version 27.5.1

可能遇到的问题：

• 启动 Docker 后，提示缺少某个包，确认安装即可

使用 Docker 的优点：

• 在有多个环境时，比如：开发、测试、生产，可以保证多环境一致

• 方便对多个应用进行管理，能看到应用的实时状态

• 各应用隔离，分配有自己的资源，互不干扰

• 当需要创建虚拟环境时，不需要每次重新下载依赖

使用 Docker 下载 Python 镜像

1 打开终端，查看所有可以安装的 Python 镜像

# 查询可安装的 Python 镜像
docker search python

可能遇到的问题：

• 查询耗时很长或失败，原因是 Docker 拉取镜像的仓库在外网，使用网络代理即可

2 拉取官方镜像

# 下载官方 Python 镜像
docker pull python:latest

可能遇到的问题：

• 拉取耗时很长或失败，原因是 Docker 拉取镜像的仓库在外网，使用网络代理即可

3 拉取完成后，进行确认，如果出现版本号，恭喜安装成功

# 获取拉取到本地的镜像
docker images
# >> python latest 08471c63c5fd 2weeksago 1.47GB