knowledge_search/SETUP_ENV.md

虚拟环境设置指南

创建虚拟环境

方法1：使用 venv（推荐）

# 创建虚拟环境（在当前目录下创建 .venv 文件夹）
python3 -m venv .venv

# 或者指定名称
python3 -m venv venv

方法2：使用 virtualenv

# 先安装 virtualenv（如果未安装）
pip install virtualenv

# 创建虚拟环境
virtualenv venv

激活虚拟环境

macOS/Linux

# 激活虚拟环境
source .venv/bin/activate

# 或者如果命名为 venv
source venv/bin/activate

激活成功后，终端提示符前会显示 (venv) 或 (.venv)

Windows

# 激活虚拟环境
.venv\Scripts\activate

# 或者如果命名为 venv
venv\Scripts\activate

停用虚拟环境

deactivate

完整设置流程

# 1. 创建虚拟环境
python3 -m venv .venv

# 2. 激活虚拟环境
source .venv/bin/activate

# 3. 升级pip（可选但推荐）
pip install --upgrade pip

# 4. 安装项目依赖
pip install -r requirements.txt

# 5. 设置环境变量
export OPENROUTER_API_KEY='your-api-key-here'

# 6. 验证安装
python --version
pip list

检查虚拟环境是否激活

# 方法1：查看Python路径
which python
# 应该显示虚拟环境路径，如：/path/to/project/.venv/bin/python

# 方法2：查看pip路径
which pip
# 应该显示虚拟环境路径，如：/path/to/project/.venv/bin/pip

# 方法3：查看环境变量
echo $VIRTUAL_ENV
# 应该显示虚拟环境路径

常见问题

1. 找不到 python3 命令

# 尝试使用 python
python -m venv .venv

# 或者查找Python安装路径
which python3

2. 权限错误

# 使用 sudo（不推荐，但有时需要）
sudo python3 -m venv .venv

3. 虚拟环境已存在

# 删除旧虚拟环境
rm -rf .venv

# 重新创建
python3 -m venv .venv

项目特定设置

对于本项目，建议使用 .venv 作为虚拟环境名称（已在 .gitignore 中忽略）

# 创建虚拟环境
python3 -m venv .venv

# 激活虚拟环境
source .venv/bin/activate

# 安装依赖
pip install -r requirements.txt

# 设置API密钥
export OPENROUTER_API_KEY='your-api-key-here'