Vibe Coding 知识库

Python 项目独立环境 ​

Python 项目应该使用独立环境。独立环境可以让每个项目拥有自己的 Python 解释器入口和依赖包，避免项目之间互相污染。

推荐目录结构 ​

text
my-python-project/
├── .venv/
├── src/
├── tests/
├── requirements.txt
└── README.md

.venv/ 是本机环境目录，不提交 Git。通常需要在 .gitignore 中加入：

gitignore
.venv/
__pycache__/
*.pyc

创建虚拟环境 ​

Windows PowerShell：

powershell
py -m venv .venv

macOS / Linux：

bash
python3 -m venv .venv

如果系统里 python 指向正确版本，也可以：

bash
python -m venv .venv

激活环境 ​

Windows PowerShell：

powershell
.\.venv\Scripts\Activate.ps1

如果 PowerShell 阻止脚本运行，先对当前用户放开本地脚本执行策略：

powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Windows cmd：

cmd
.venv\Scripts\activate.bat

macOS / Linux：

bash
source .venv/bin/activate

退出环境：

bash
deactivate

安装依赖 ​

激活后：

bash
python -m pip install --upgrade pip
python -m pip install requests
python -m pip freeze > requirements.txt

别人拉取项目后：

bash
python -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt

Windows PowerShell 对应：

powershell
py -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -r requirements.txt

多 Python 版本项目 ​

如果项目指定 Python 版本，把版本写清楚：

text
Python 3.12

Windows 可以用 Python Launcher 指定版本：

powershell
py -3.12 -m venv .venv

macOS / Linux 可以使用系统包、pyenv、容器或 CI 镜像来固定版本。

给 AI 编程助手的项目提示 ​

可以在项目说明里写：

markdown
## Python 环境

- 使用 Python 3.12。
- 依赖安装在项目根目录 `.venv/`。
- 不要把 `.venv/` 提交到 Git。
- 新依赖安装后更新 `requirements.txt`。
- 运行脚本前先激活虚拟环境。

来源 ​