diff --git a/Tech/programming-language/Python/项目/虚拟环境/pipenv.md b/Tech/programming-language/Python/项目/虚拟环境/pipenv.md index 20d9b332..67f86d86 100644 --- a/Tech/programming-language/Python/项目/虚拟环境/pipenv.md +++ b/Tech/programming-language/Python/项目/虚拟环境/pipenv.md @@ -58,13 +58,13 @@ $ pip3 install --user pipenv ```mermaid graph LR A[开始] --> B[克隆/创建项目] - B --> C[安装依赖: pipenv sync] - C --> D[添加包: pipenv install ] - D --> E[更新全部依赖: pipenv update] - E --> F[更新特定包: pipenv update ] - F --> G[检查过时包: pipenv update --outdated] - G --> H[确定虚拟环境路径: pipenv --venv] - H --> I[激活 Pipenv shell: pipenv shell] + B --> C[安装依赖] + C --> D[添加包] + D --> E[更新全部依赖] + E --> F[更新特定包] + F --> G[检查过时包] + G --> H[确定虚拟环境路径] + 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] | 卸载特定的包 | diff --git a/Tech/programming-language/Python/项目/虚拟环境/pyenv.md b/Tech/programming-language/Python/项目/虚拟环境/pyenv.md new file mode 100644 index 00000000..7e64257b --- /dev/null +++ b/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 ` 来安装该版本（如 `3.8.5`）。 + +### 2. 创建项目目录 + +为你的项目创建一个新目录，或者导航到现有项目的目录。 + +### 3. 设置项目的 Python 版本 + +在项目目录中，使用 `pyenv local ` 设置项目使用的 Python 版本。这将在当前目录创建一个 `.python-version` 文件，指定该目录下所有命令应使用的 Python 版本。 + +### 4. 验证 Python 版本 + +在项目目录中运行 `python --version` 确保正确的 Python 版本被激活。 + +### 5. （可选）集成虚拟环境 + +虽然 `pyenv` 本身不直接处理虚拟环境，但它与 `pipenv`、`virtualenv` 等工具兼容。如果需要，可以现在设置虚拟环境： + +- 使用 `pipenv`：运行 `pipenv install` 来创建虚拟环境并生成 `Pipfile`。 +- 使用 `virtualenv`：首先安装 `pyenv-virtualenv` 插件，然后使用 `pyenv virtualenv ` 创建一个新的虚拟环境。 + +### 6. 激活虚拟环境（如果使用） + +如果你使用了虚拟环境工具： + +- 对于 `pipenv`：使用 `pipenv shell` 来激活虚拟环境。 +- 对于 `pyenv-virtualenv`：虚拟环境将根据 `.python-version` 或 `pyenv local ` 自动激活。 + +### 7. 安装依赖 + +在激活的虚拟环境中，使用 `pip` 或 `pipenv` 安装项目所需的所有依赖。 + +### 8. 开发和测试 + +进行你的正常开发工作。只要你在项目目录中，`pyenv` 和虚拟环境都会确保使用正确的 Python 版本和依赖。 + +### 9. 提交和共享 + +在项目的版本控制系统（如 Git）中提交 `.python-version` 文件（不要提交虚拟环境）。这样，其他开发者可以了解并使用相同的 Python 版本。 + +## 命令 + +| 命令 | 描述 | 示例/注释 | +| --------------------------------------- | ------------------------------------- | ------------------------------------------------------------ | +| `pyenv install ` | 安装指定的 Python 版本 | `pyenv install 3.8.5` 安装 Python 3.8.5 | +| `pyenv uninstall ` | 卸载指定的 Python 版本 | `pyenv uninstall 3.8.5` 卸载 Python 3.8.5 | +| `pyenv versions` | 列出所有已安装的 Python 版本 | 列出系统中所有可用的 Python 版本 | +| `pyenv version` | 显示当前激活的 Python 版本 | 显示当前会话或全局设置的 Python 版本 | +| `pyenv global ` | 设置全局默认的 Python 版本 | `pyenv global 3.8.5` 设置全局版本为 3.8.5 | +| `pyenv local ` | 设置当前目录的 Python 版本 | `pyenv local 3.7.7` 设置当前目录的 Python 版本 | +| `pyenv shell ` | 设置当前会话的 Python 版本 | `pyenv shell 3.6.9` 临时更改会话的 Python 版本 | +| `pyenv rehash` | 重新计算并安装 shim | 在安装新版本或卸载后更新 shim | +| `pyenv which ` | 显示特定命令的路径 | `pyenv which pip` 显示 `pip` 命令的路径 | +| `pyenv exec ` | 在选定的 Python 环境中执行命令 | `pyenv exec pip list` 在当前环境中运行 `pip list` | +| `pyenv init` | 用于配置 shell 环境 | 通常添加到 `.bashrc` 或 `.zshrc` | +| `pyenv virtualenvs` | 列出所有已创建的虚拟环境 | 列出系统中所有已创建的虚拟环境 | +| `pyenv virtualenv ` | 创建一个新的虚拟环境 | `pyenv virtualenv 3.8.5 myenv` 创建名为 `myenv` 的虚拟环境 | +| `pyenv virtualenv-delete ` | 删除指定虚拟环境 | `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` 文件路径 |