Mac 安装 Pyenv 管理 python

## 安装 pyenv

### 方式 A：自动安装脚本（推荐）

这是最简单的方法，适用于 Linux 和 macOS：

**Bash**

```
curl https://pyenv.run | bash
```

### 方式 B：Homebrew 安装 (仅限 macOS)

**Bash**

```
brew update
brew install pyenv
```

### 如果你使用的是 **Zsh** (macOS 默认或大部分 Linux 用户)

执行这一组命令：

**Bash**

```
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
echo '[[ -d $PYENV_ROOT/bin ]] && export PATH="$PATH:$PYENV_ROOT/bin"' >> ~/.zshrc
echo 'eval "$(pyenv init -)"' >> ~/.zshrc
# 立即生效
source ~/.zshrc
```

## 4. 常用操作命令

### 查看可安装版本

**Bash**

```
pyenv install --list        # 列出所有可用的 Python 版本
pyenv install --list | grep "3.10"  # 过滤查看 3.10 的版本
```

### 安装与卸载

**Bash**

```
pyenv install 3.10.12       # 安装指定版本
pyenv uninstall 3.10.12     # 卸载指定版本
```

### 查看已安装状态

**Bash**

```
pyenv versions              # 查看本地已安装的所有版本（* 表示当前选中）
pyenv version               # 查看当前正在使用的版本
```

### 切换版本（核心功能）

1. **全局设置** (修改系统默认使用的 Python)：
   **Bash**
   
   ```
   pyenv global 3.10.12
   ```
2. **本地设置** (针对某个项目目录，在该目录下有效)：
   **Bash**
   
   ```
   cd my_project/
   pyenv local 3.9.18      # 会在当前目录生成一个 .python-version 文件
   ```
3. **当前 Shell 会话设置** (仅在当前终端窗口有效)：
   **Bash**
   
   ```
   pyenv shell 3.11.5
   ```

既然你已经成功切换到了 **Python 3.11.14**，现在安装 `requirements.txt` 中的依赖包就非常简单了。

为了确保安装包时使用的是你刚才设置的 `pyenv` 环境，建议按照以下步骤操作：

---

## 1. 基础安装命令

在包含 `requirements.txt` 文件的目录下，运行以下命令：

**Bash**

```
python -m pip install -r requirements.txt
```

> **注意：** 使用 `python -m pip` 而不仅仅是 `pip`，可以百分之百确保安装包被放在当前 `pyenv` 选中的 Python 3.11 路径下，避免安装到了系统 Python 里。

---

## 2. 推荐：使用国内镜像源（加速下载）

如果你发现下载速度很慢或者经常断开，可以使用国内的清华大学镜像源，速度会快非常多：

**Bash**

```
python -m pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
```

---

## 3. 进阶建议：使用虚拟环境 (Virtualenv)

虽然你已经在用 `pyenv` 切换版本，但如果你有多个 Python 3.11 的项目，它们的第三方包（如 `pandas`, `requests` 等）可能会发生版本冲突。

**强烈建议**在项目目录下创建一个“隔离层”：

1. **创建虚拟环境**（就在你的项目文件夹里）：
   **Bash**
   
   ```
   python -m venv venv
   ```
2. **激活虚拟环境**：
   **Bash**
   
   ```
   source venv/bin/activate
   ```
   
   *激活后，你的终端提示符前面通常会出现 `(venv)` 字样。*
3. **在虚拟环境中安装依赖**：
   **Bash**
   
   ```
   pip install -r requirements.txt
   ```

---

## 4. 如何确认安装成功？

安装完成后，你可以运行以下命令查看已安装的所有包：

**Bash**

```
pip list
```

或者检查某个特定的包是否能被导入：

**Bash**

```
python -c "import 某个包名; print('成功')"
```

最后修改：2025 年 12 月 27 日

如果觉得我的文章对你有用，请随意赞赏

Mac 安装 Pyenv 管理 python

此内容被密码保护

浏览器渲染原理

冻结屏幕并检查消失的元素

[Ubuntu] 告别断连风险：如何安全地给服务器添加第二个 IP 地址 (Netplan 自动化脚本)

一键部署脚本 (Host 模式 + 8443端口)

安装vertex后，如何集成到swizzin中？

docker 安装 qbittorrent

浏览器渲染原理

Mac 安装 Pyenv 管理 python

rclone 同步脚本

Mac 安装 Pyenv 管理 python