268 字
1 分钟
虚拟环境与依赖
虚拟环境与依赖
不同项目需要不同依赖。RAG 可能需要向量库,Agent 可能需要工具框架,数据处理可能需要 Pandas。如果所有包都装到全局环境,迟早会版本冲突。
虚拟环境的作用,就是给每个项目一个独立的 Python 包空间。
创建虚拟环境
python -m venv .venvWindows PowerShell 激活:
.venv\Scripts\Activate.ps1macOS / Linux 激活:
source .venv/bin/activate激活后,命令行前面通常会出现 (.venv)。
安装依赖
pip install requests python-dotenv保存依赖:
pip freeze > requirements.txt别人拿到项目后可以安装:
pip install -r requirements.txtLLM 项目常见依赖
| 依赖 | 用途 |
|---|---|
| requests/httpx | HTTP API 调用 |
| python-dotenv | 读取 .env |
| pandas | 数据清洗 |
| numpy | 向量计算 |
| pydantic | 数据结构校验 |
.gitignore
不要提交虚拟环境:
.venv/__pycache__/.env常见错误
- 忘记激活虚拟环境就安装依赖。
- 把
.venv提交到 Git。 - 不保存
requirements.txt。 - 多个项目共用全局依赖导致版本冲突。
最小练习
创建一个 hello-python 项目:
- 创建
.venv。 - 安装
python-dotenv。 - 写一个读取
.env的脚本。 - 生成
requirements.txt。