Python venv 虚拟环境

虚拟环境为项目提供独立的 Python 包目录，避免不同项目的依赖版本互相影响。虚拟环境通常命名为 .venv，不应提交到 Git，也不适合在机器之间直接复制。

创建虚拟环境

python -m venv .venv

虚拟环境基于执行该命令的 Python 解释器创建。需要指定版本时，应先选择相应解释器：

python3.12 -m venv .venv

Windows PowerShell：

.\.venv\Scripts\Activate.ps1

Windows 命令提示符：

.\.venv\Scripts\activate.bat

Linux 或 macOS：

source .venv/bin/activate

激活不是必需步骤，也可以直接调用虚拟环境中的解释器。

Linux 或 macOS：

command -v python
python -c "import sys; print(sys.executable)"

Windows PowerShell：

Get-Command python
python -c "import sys; print(sys.executable)"

python -m pip install package_name
python -m pip freeze > requirements.txt
python -m pip install -r requirements.txt

使用 python -m pip 可以明确让 pip 对应当前选择的 Python 解释器。

在项目的 .gitignore 中加入：

.venv/

虚拟环境应视为可重新创建的目录；项目代码和必要依赖声明应保存在虚拟环境之外。

deactivate