【PyCharm】让 PyCharm 使用 .venv 虚拟环境

发布时间:2026/8/11 12:34:54
【PyCharm】让 PyCharm 使用 .venv 虚拟环境 问题分析PyCharm 运行项目时会使用你在Run Configuration中配置的 Python 解释器。而当你通过 Git Bash 执行/**-start.sh运行脚本时该脚本会在内部自动创建并使用.venv虚拟环境并安装所有必要的依赖包。这是两个完全不同的 Python 环境环境解释器路径依赖包位置依赖状态脚本启动backend/.venv/Scripts/python.exebackend/.venv/Lib/site-packagesPyCharm 运行D:\anaconda3\python.exeD:\anaconda3\Lib\site-packages解决方案让 PyCharm 使用 .venv 虚拟环境步骤 1先在终端创建并安装依赖打开 “Git Bash“ 或 PyCharm Terminal执行cd backend # 如果 .venv 不存在创建它 python -m venv .venv # 激活虚拟环境 # Windows Git Bash: source .venv/Scripts/activate # 或 Windows CMD/PowerShell: .venv\Scripts\activate # 安装所有依赖 pip install -r requirements.txt步骤 2在 PyCharm 中配置使用 .venv1. 打开 PyCharm 设置- File → Settings或 Ctrl Alt S2. 进入 Python 解释器配置- Project: smart-printing-agent → Python Interpreter3. 添加现有虚拟环境- 点击右上角齿轮 ⚙️ 图标 → Add- 选择 Existing environment- Interpreter 路径选择backend\.venv\Scripts\python.exe- 点击 OK4. 确认依赖包- 此时你应该能看到 .venv 中已安装的所有依赖包列表5. 编辑 Run Configuration- 点击 PyCharm 顶部工具栏的运行配置下拉菜单 → Edit Configurations- 确保选中的 Python interpreter 是 backend\.venv\Scripts\python.exe- 确保 Working directory 是 backend步骤 3验证配置完成后PyCharm 右下角应该显示 Python 3.12 (.venv) 或类似的虚拟环境名称。再次点击运行按钮就不会再报依赖缺失了。补充如果 .venv 不存在如果你的 scripts/start-dev-all.sh 之前已经创建了 .venv但在 PyCharm 中看不到可能是因为1. .venv 在 backend/ 目录下不在项目根目录2. PyCharm 项目根目录设置不同检查一下 backend/ 目录下是否存在 .venv 文件夹ls backend\.venv如果存在直接在 PyCharm 中指向 backend\.venv\Scripts\python.exe 即可。