268 字
1 分钟
虚拟环境与依赖

虚拟环境与依赖#

不同项目需要不同依赖。RAG 可能需要向量库,Agent 可能需要工具框架,数据处理可能需要 Pandas。如果所有包都装到全局环境,迟早会版本冲突。

虚拟环境的作用,就是给每个项目一个独立的 Python 包空间。

创建虚拟环境#

Terminal window
python -m venv .venv

Windows PowerShell 激活:

Terminal window
.venv\Scripts\Activate.ps1

macOS / Linux 激活:

Terminal window
source .venv/bin/activate

激活后,命令行前面通常会出现 (.venv)

安装依赖#

Terminal window
pip install requests python-dotenv

保存依赖:

Terminal window
pip freeze > requirements.txt

别人拿到项目后可以安装:

Terminal window
pip install -r requirements.txt

LLM 项目常见依赖#

依赖用途
requests/httpxHTTP API 调用
python-dotenv读取 .env
pandas数据清洗
numpy向量计算
pydantic数据结构校验

.gitignore#

不要提交虚拟环境:

.venv/
__pycache__/
.env

常见错误#

  • 忘记激活虚拟环境就安装依赖。
  • .venv 提交到 Git。
  • 不保存 requirements.txt
  • 多个项目共用全局依赖导致版本冲突。

最小练习#

创建一个 hello-python 项目:

  1. 创建 .venv
  2. 安装 python-dotenv
  3. 写一个读取 .env 的脚本。
  4. 生成 requirements.txt
虚拟环境与依赖
https://llmhello.com/posts/2026_07/python-venv-dependencies/
作者
Happy Zhuang
发布于
2026-07-09
许可协议
CC BY-NC-SA 4.0