用途：规范 Python 项目环境的创建与安装方式，确保环境与项目放在一起，便于编辑器、工具和他人克隆后自动识别。
主要能力与用法：在项目目录内创建环境，推荐项目根目录的 .venv： python3 -m venv .venv source .venv/bin/activate pip install -e . 新项目可优先用 uv，它会管理项目级 .venv 且更快： uv venv uv pip install -e . # 或有 lockfile 时用 uv sync uv run python -m yourpkg # 无需激活即在项目环境运行
限制与注意：不要把环境放在 /tmp、~/envs 等项目外的临时位置，用户工具无法发现，/tmp 中还会被删除。Homebrew、Debian、Ubuntu 将系统解释器标记为外部管理，虚拟环境外 pip install 会报 externally-managed-environment；这是应创建项目环境的信号，不要使用 --break-system-packages、设置 PIP_BREAK_SYSTEM_PACKAGES 或删除 EXTERNALLY-MANAGED 标记。交付运行说明时基于项目环境，例如 source .venv/bin/activate 后 python -m yourpkg，或用 uv run python -m yourpkg，不要给出指向项目外环境的绝对路径。若项目已有 .venv、uv.lock、Poetry、Pipenv、conda 等，应先检查并沿用，不要新建第二套环境。