Python 虚拟环境配置笔记：环境迁移与重新激活

1. 背景描述

在开发 项目时，原本在项目的顶层目录（Root Directory）下配置了.venv虚拟环境。为了使项目结构更清晰或配合特定的模块逻辑，决定将虚拟环境移动到二级目录（例如knowledge/文件夹）中重新构建。

2. 操作过程记录

步骤一：清理顶层环境

首先，手动或通过命令行删除了位于项目根目录下的旧虚拟环境文件夹：

• 路径：D:\\pycharm-workspace\\shopkeeper_brain\\.venv

步骤二：进入二级目录并创建新环境

在终端中进入目标文件夹：

cd knowledge

在该目录下初始化新的虚拟环境：

python-m venv.venv

步骤三：激活新环境

使用 PowerShell 脚本激活位于二级目录下的环境：

.\\.venv\\Scripts\\Activate.ps1

3. 核心命令详解

3.1 退出环境：deactivate

• 用途：当你还在旧的或不需要的虚拟环境中时，输入此命令可以安全退出。
• 表现：命令行前面的(.venv)标识会消失。

3.2 激活环境路径解析

.\\.venv\\Scripts\\Activate.ps1

• .\\：代表当前所在的目录（即knowledge目录）。
• .venv\\：进入刚才创建的虚拟环境文件夹。
• Scripts\\：Windows 系统下 Python 环境的可执行脚本存放处。
• Activate.ps1：专门用于 PowerShell 的激活脚本。

4. 常见问题记录

Q: 为什么要把环境建在二级目录？

• 场景：如果你的项目是一个 Monorepo（大仓库），里面包含多个独立的子服务（如knowledge是一个独立的知识库处理模块），在子目录建立环境可以方便每个模块拥有独立的依赖包。

Q: 运行 Activate.ps1 报错“禁止执行脚本”怎么办？

如果在激活时遇到权限问题，需要以管理员身份运行 PowerShell 并执行以下命令来放开权限：

Set-ExecutionPolicy-ExecutionPolicy RemoteSigned-Scope CurrentUser

5. 总结

通过这次调整，项目环境现在更加贴合shopkeeper_brain\\knowledge的开发需求。后续在该目录下开发时，只需执行激活脚本，即可确保所有的库（如 LangChain, PyTorch 等）都安装在正确的隔离空间内。