Python: pyenv 多版本管理器

Tech/programming-language/Python/项目/虚拟环境/pipenv.md

@@ -58,13 +58,13 @@ $ pip3 install --user pipenv
 ```mermaid
 graph LR
     A[开始] --> B[克隆/创建项目]
-    B --> C[安装依赖: pipenv sync]
+    B --> C[安装依赖]
-    C --> D[添加包: pipenv install <package>]
+    C --> D[添加包]
-    D --> E[更新全部依赖: pipenv update]
+    D --> E[更新全部依赖]
-    E --> F[更新特定包: pipenv update <package>]
+    E --> F[更新特定包]
-    F --> G[检查过时包: pipenv update --outdated]
+    F --> G[检查过时包]
-    G --> H[确定虚拟环境路径: pipenv --venv]
+    G --> H[确定虚拟环境路径]
-    H --> I[激活 Pipenv shell: pipenv shell]
+    H --> I[激活 Pipenv shell]
 ```
 
 ``````shell
@@ -132,6 +132,7 @@ pipenv sync
 | 命令                               | 用途                                             |
 | ---------------------------------- | ------------------------------------------------ |
 | pipenv install                     | 安装项目所需的包                                 |
+| pipenv install --python [version]  | 安装项目指定的 python 版本（使用 pyenv）         |
 | pipenv install [package]           | 安装特定的包                                     |
 | pipenv install --dev [package]     | 安装用于开发环境的包                             |
 | pipenv uninstall [package]         | 卸载特定的包                                     |

Tech/programming-language/Python/项目/虚拟环境/pyenv.md

@@ -0,0 +1,115 @@
+---
+title: pyenv
+description: pyenv是一个流行的Python版本管理工具，它允许你在同一系统上安装和使用多个Python版本。
+keywords:
+  - pyenv
+  - 虚拟环境
+  - Python
+tags:
+  - Python/虚拟环境
+author: 仲平
+date: 2023-12-22
+---
+
+## 概述
+
+Python 是一种广泛使用的高级编程语言，以其易读性和强大的库支持而闻名。然而，随着项目数量和复杂性的增加，管理不同项目所需的不同 Python 版本和依赖成为了一个挑战。`pyenv` 和 `pipenv` 是两个解决这些问题的强大工具，能够帮助开发者有效地管理多个 Python 版本和项目环境。
+
+`pyenv` 是一个流行的 Python 版本管理工具，它允许你在同一系统上安装和使用多个 Python 版本。它提供了一个干净的方式来切换全局 Python 版本，也可以在项目级别设置特定的 Python 版本。
+
+## 实现
+
+`pyenv` 实现多版本 Python 管理的核心是通过拦截 Python 命令，选择并使用特定的 Python 版本。这是通过几个关键步骤和机制实现的：
+
+### 1. 改变 PATH 环境变量
+
+`pyenv` 在你的 `PATH` 环境变量前面插入一个 `shims` 目录。当你运行 `python` 或 Python 包的任何命令时，实际上你首先运行的是一个 `shim`。
+
+### 2. 使用 Shims
+
+**Shims**是一种轻量级的转发脚本，它们决定实际调用哪个 Python 版本。当你运行 `python` 时，`shim` 会查询 `pyenv` 以确定使用哪个版本的 Python。
+
+### 3. 版本选择
+
+`pyenv` 根据多个因素确定使用哪个 Python 版本，包括：
+
+- 全局版本：你通过 `pyenv global` 设置的系统范围的默认版本。
+- 项目级别版本：通过 `pyenv local` 在特定项目目录下设置的版本。
+- Shell 临时版本：通过 `pyenv shell` 为当前会话设置的版本。
+- 版本继承：如果你在一个没有本地版本设置的目录中，`pyenv` 会向上查找父目录直到找到一个版本或达到全局版本。
+
+### 4. 构建和安装 Python
+
+当你要求安装新的 Python 版本时，`pyenv` 会下载源代码，然后根据你的系统配置编译它。完成后，该特定版本的 Python 将被安装在 `~/.pyenv/versions` 目录下。
+
+### 5. 灵活性和可扩展性
+
+- `pyenv` 可以通过插件来扩展，如 `pyenv-virtualenv`，提供对虚拟环境的支持。
+- 它不会覆盖系统 Python 版本，而是允许你在系统 Python 和任意数量的不同版本之间切换。
+
+## 使用
+
+### 1. 安装 Python 版本
+
+确定项目需要哪个 Python 版本。使用 `pyenv install <version>` 来安装该版本（如 `3.8.5`）。
+
+### 2. 创建项目目录
+
+为你的项目创建一个新目录，或者导航到现有项目的目录。
+
+### 3. 设置项目的 Python 版本
+
+在项目目录中，使用 `pyenv local <version>` 设置项目使用的 Python 版本。这将在当前目录创建一个 `.python-version` 文件，指定该目录下所有命令应使用的 Python 版本。
+
+### 4. 验证 Python 版本
+
+在项目目录中运行 `python --version` 确保正确的 Python 版本被激活。
+
+### 5. （可选）集成虚拟环境
+
+虽然 `pyenv` 本身不直接处理虚拟环境，但它与 `pipenv`、`virtualenv` 等工具兼容。如果需要，可以现在设置虚拟环境：
+
+- 使用 `pipenv`：运行 `pipenv install` 来创建虚拟环境并生成 `Pipfile`。
+- 使用 `virtualenv`：首先安装 `pyenv-virtualenv` 插件，然后使用 `pyenv virtualenv <version> <env-name>` 创建一个新的虚拟环境。
+
+### 6. 激活虚拟环境（如果使用）
+
+如果你使用了虚拟环境工具：
+
+- 对于 `pipenv`：使用 `pipenv shell` 来激活虚拟环境。
+- 对于 `pyenv-virtualenv`：虚拟环境将根据 `.python-version` 或 `pyenv local <env-name>` 自动激活。
+
+### 7. 安装依赖
+
+在激活的虚拟环境中，使用 `pip` 或 `pipenv` 安装项目所需的所有依赖。
+
+### 8. 开发和测试
+
+进行你的正常开发工作。只要你在项目目录中，`pyenv` 和虚拟环境都会确保使用正确的 Python 版本和依赖。
+
+### 9. 提交和共享
+
+在项目的版本控制系统（如 Git）中提交 `.python-version` 文件（不要提交虚拟环境）。这样，其他开发者可以了解并使用相同的 Python 版本。
+
+## 命令
+
+| 命令                                    | 描述                                  | 示例/注释                                                    |
+| --------------------------------------- | ------------------------------------- | ------------------------------------------------------------ |
+| `pyenv install <version>`               | 安装指定的 Python 版本                  | `pyenv install 3.8.5` 安装 Python 3.8.5                       |
+| `pyenv uninstall <version>`             | 卸载指定的 Python 版本                  | `pyenv uninstall 3.8.5` 卸载 Python 3.8.5                     |
+| `pyenv versions`                        | 列出所有已安装的 Python 版本            | 列出系统中所有可用的 Python 版本                               |
+| `pyenv version`                         | 显示当前激活的 Python 版本              | 显示当前会话或全局设置的 Python 版本                           |
+| `pyenv global <version>`                | 设置全局默认的 Python 版本              | `pyenv global 3.8.5` 设置全局版本为 3.8.5                     |
+| `pyenv local <version>`                 | 设置当前目录的 Python 版本              | `pyenv local 3.7.7` 设置当前目录的 Python 版本                 |
+| `pyenv shell <version>`                 | 设置当前会话的 Python 版本              | `pyenv shell 3.6.9` 临时更改会话的 Python 版本                 |
+| `pyenv rehash`                          | 重新计算并安装 shim                    | 在安装新版本或卸载后更新 shim                                 |
+| `pyenv which <command>`                 | 显示特定命令的路径                    | `pyenv which pip` 显示 `pip` 命令的路径                        |
+| `pyenv exec <command>`                  | 在选定的 Python 环境中执行命令          | `pyenv exec pip list` 在当前环境中运行 `pip list`             |
+| `pyenv init`                            | 用于配置 shell 环境                     | 通常添加到 `.bashrc` 或 `.zshrc`                                |
+| `pyenv virtualenvs`                     | 列出所有已创建的虚拟环境              | 列出系统中所有已创建的虚拟环境                               |
+| `pyenv virtualenv <version> <env-name>` | 创建一个新的虚拟环境                  | `pyenv virtualenv 3.8.5 myenv` 创建名为 `myenv` 的虚拟环境     |
+| `pyenv virtualenv-delete <env-name>`    | 删除指定虚拟环境                      | `pyenv virtualenv-delete myenv` 删除名为 `myenv` 的虚拟环境    |
+| `pyenv local --unset`                   | 取消项目级别的 Python 版本设置          | `pyenv local --unset` 取消项目目录下的 Python 版本设置         |
+| `pyenv shell --unset`                   | 取消会话级别的 Python 版本设置          | `pyenv shell --unset` 取消会话中的 Python 版本设置             |
+| `pyenv local --unset-all`               | 取消所有项目级别的 Python 版本设置      | `pyenv local --unset-all` 取消所有项目目录下的 Python 版本设置 |
+| `pyenv version-file`                    | 查找当前目录下的 `.python-version` 文件 | `pyenv version-file` 查找并显示当前目录下的 `.python-version` 文件路径 |