Python Pip 常用命令与venv虚拟环境

Python 解释器

Python 解释器是你与 Python 代码沟通的桥梁。虽然我们常在 IDE 中工作，但理解其命令行用法至关重要。

1. 查看版本：确认你的“武器”

这是你排查环境问题时最先应该做的命令。

python --version
# 或者使用更详细的 -V 标志
python -V

提示： 在某些系统中，你可能需要使用 python3。这取决于你的环境配置。

2. 交互模式：你的“即时沙盒”

当你想快速测试一段代码、调试一个函数或查看某个库的用法时，无需创建文件。

python

进入后，你会看到 >>> 提示符。在这里，你可以即时执行 Python 代码并获得结果。按 Ctrl + D (Linux/macOS) 或 Ctrl + Z 然后 Enter (Windows) 即可退出。

3. 执行脚本：最核心的用途

这是将 .py 文件变为可运行程序的方式。

python your_script.py

4. 以模块方式运行：最佳实践的入口

这是一个非常重要的用法！它允许你将 Python 的标准库或已安装的包作为脚本来运行。最典型的例子就是用它来调用 pip，这能确保你使用的是当前 Python 环境关联的 pip，避免路径混乱。

python -m pip --version

记住这个模式，python -m <module_name>，在后续的虚拟环境和包管理中，它会是你最可靠的朋友。

---

pip 常用命令

pip 是 Python 的包安装程序，负责从 PyPI (Python Package Index) 下载和管理第三方库。

1. 安装包：pip install

这是 pip 最常用的命令，但它的用法远不止 pip install requests 这么简单。

• 安装最新版本：

  pip install requests
  

• 安装指定版本： 项目稳定性的基石。

  pip install requests==2.25.1
  

• 安装版本范围： 灵活性与兼容性的平衡。

  pip install "requests>=2.25,<3.0"
  

• 从 requirements.txt 安装： 团队协作与项目部署的核心。

  pip install -r requirements.txt
  

  这个文件定义了项目所需的所有包及其精确版本，是保证环境一致性的“宪法”。

• 升级包：

  pip install --upgrade requests
  

2. 卸载包：pip uninstall

清理不再需要的包，保持环境整洁。

pip uninstall requests

3. 查看包信息：pip show 与 pip list

• pip show <package_name>：查看单个包的详细信息，如版本、依赖、作者等。

  pip show requests
  

• pip list：列出当前环境中所有已安装的包。

  pip list
  

4. 生成依赖文件：pip freeze

与 pip install -r 相辅相成，用于创建 requirements.txt 文件。

pip freeze > requirements.txt

最佳实践： 在项目根目录下执行此命令，将 requirements.txt 纳入版本控制（如 Git）。

---

venv 虚拟环境

这是本文的重点！ 如果说 Python 和 pip 是工具，那么虚拟环境就是使用这些工具的“专业工作台”。

为什么需要虚拟环境？

想象一下，你同时在开发两个项目：

• 项目 A：是一个老项目，依赖 Django==3.2。
• 项目 B：是一个新项目，需要使用 Django==4.2 的新特性。

如果你在全局环境中安装，这两个版本的 Django 会互相覆盖，导致至少一个项目无法运行。这就是“依赖地狱”。

虚拟环境就是为每一个项目创建一个独立、隔离的 Python 运行空间。每个空间都有自己的 Python 解释器和 pip，安装的包互不影响。

如何使用虚拟环境？（三步走）

Python 3.3+ 内置了 venv 模块来创建虚拟环境，无需额外安装。

第一步：创建虚拟环境

在你的项目根目录下，打开终端执行：

# 推荐将虚拟环境命名为 venv 或 .ven
python -m venv venv

执行后，你会看到一个名为 venv 的文件夹，里面包含了该环境的 Python 副本和相关工具。

第二步：激活虚拟环境

创建后，必须“激活”它才能进入这个隔离空间。

• 在 Linux / macOS 上:

  source venv/bin/activate
  

• 在 Windows (CMD) 上:

  .\venv\Scripts\activate.bat
  

• 在 Windows (PowerShell) 上:

  .\venv\Scripts\Activate.ps1
  

  如果 PowerShell 提示“无法加载文件…因为在此系统上禁止运行脚本”，请以管理员身份运行 PowerShell，执行 Set-ExecutionPolicy RemoteSigned，然后选择 Y。

激活成功后，你的命令行提示符前会出现 (venv) 字样，这表示你已“身处”虚拟环境中。

第三步：在虚拟环境中工作

现在，你所有的 Python 和 pip 命令都指向了这个独立的环境。

# 此时安装的任何包都只在 venv 环境内
(venv) $ pip install django
(venv) $ pip freeze > requirements.txt# 运行你的项目
(venv) $ python manage.py runserver

当你完成工作，想退出这个“隔离舱”时，只需一个简单的命令：

deactivate

执行后，(venv) 前缀消失，你便回到了全局环境。