.venv 是 Python 的虚拟环境目录，用来把当前项目的依赖和系统的 Python 隔离开，避免包版本冲突。下面按常见场景给你一套“够用且规范”的用法说明。

一、先搞清楚：.venv 是什么？

• .venv/ 是一个文件夹

• 里面包含：

• 独立的 Python 解释器

• 独立的 pip

• 独立的 site-packages（你装的第三方库都在这里）

✅ 好处：

不同项目可以用不同版本的库，不会互相影响。

二、创建虚拟环境（如果还没有）

在项目根目录执行：

bashpython -m venv .venv

不同系统可能用：

• Windows: python

• macOS/Linux: python3

创建完成后你会看到：

text项目目录/
├── .venv/
├── main.py
└── requirements.txt

三、激活虚拟环境（关键步骤）

✅ Windows（CMD / PowerShell）

CMD：

bat.venv\Scripts\activate

PowerShell：

powershell.venv\Scripts\Activate.ps1

如果 PowerShell 报错，先执行：

powershellSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

✅ macOS / Linux

bashsource .venv/bin/activate

✅ 激活成功标志

命令行前面会出现：

text(.venv)

例如：

text(.venv) D:\project>

这说明你现在用的是 .venv 里的 Python。

四、在 .venv 里安装依赖

激活后直接用 pip：

bashpip install requests

验证：

bashwhich python    # macOS/Linuxwhere python    # Windows

应该指向 .venv 目录里。

五、运行你的 Python 项目

bashpython main.py

或：

bashpython -m uvicorn main:app --reload

只要前面有 (.venv)，就是在虚拟环境里运行。

六、保存 / 恢复依赖（非常重要）

保存当前环境依赖

bashpip freeze > requirements.txt

在新环境一键安装

bashpip install -r requirements.txt

✅ 团队协作、部署服务器必备

七、退出虚拟环境

bashdeactivate

命令行前的 (.venv) 会消失。

八、常见问题 & 注意事项

1️⃣ .venv 要不要提交到 Git？

❌ 不要

在 .gitignore 里加：

gitignore.venv/
venv/env/

2️⃣ 为什么我 pip install 还是装到系统里？

👉 没激活虚拟环境

👉 或用了 sudo pip

✅ 正确做法：先 activate，再 pip install

3️⃣ VS Code / PyCharm 怎么用？

• VS Code：
  Ctrl + Shift + P → Python: Select Interpreter → 选 .venv

• PyCharm：
  Settings → Python Interpreter → 指向 .venv

九、推荐的标准工作流 ✅

bash# 1. 创建python -m venv .venv# 2. 激活source .venv/bin/activate   # macOS/Linux.venv\Scripts\activate      # Windows# 3. 安装依赖pip install -r requirements.txt# 4. 开发python main.py# 5. 退出deactivate

虚拟环境中pip安装报错处理方法

用 python -m pip（100% 有效）

不要直接用 pip，改用：

powershellpython -m pip install requests

✅ 这是官方推荐方式

✅ 不依赖 pip.exe 的写死路径

✅ 一定用的是当前 .venv 里的 Python

👉 以后统一用：

powershellpython -m pip install xxx
python -m pip freeze
python -m pip install -r requirements.txt