HomeBrew Docker Python在MacBook上的安装配置指南(一)使用笔记

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

文章目录

  • 在 MacBook 上安装并配置 HomeBrew + Docker + Python
  • 安装 HomeBrew
  • 安装本地 Python
  • 安装 Pyenv
  • 使用 Pyenv 安装 Python
  • 安装容器 Python
  • 安装 Docker
  • 使用 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
    

    作者:death_knights

    物联沃分享整理
    物联沃-IOTWORD物联网 » HomeBrew Docker Python在MacBook上的安装配置指南(一)使用笔记

    发表回复