必须手动指定./venv路径创建虚拟环境，再通过mkdir/touch构建src/tests/config目录结构，配置pyproject.toml与.gitignore，安装pytest/black/mypy等开发依赖，最后验证python -m my_project.main可执行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Cursor中从零开始创建一个可维护、可协作的Python项目，必须避开脚本式开发陷阱，确保结构清晰、依赖隔离、配置显式——否则后续添加测试、接入CI或多人并行开发时会反复踩坑。
初始化项目目录与虚拟环境
打开Cursor → 点击左上角 File → New Folder → 命名为 my_project 并选择本地路径 → 按 Cmd+Shift+P（macOS）或 Ctrl+Shift+P（Windows/Linux）调出命令面板 → 输入 Python: Create Environment → 选择 venv → 设置环境路径为 ./venv。
这一步必须手动指定 【./venv 路径】，不能接受默认的系统级位置，否则会导致团队成员拉取代码后无法复现一致环境；Cursor不会自动将该目录加入 .gitignore，需后续手动补全。
生成标准化项目骨架
方法一：用内置终端快速搭建基础结构
在Cursor底部终端中执行：
mkdir -p src/my_project tests config scripts → touch src/my_project/__init__.py src/my_project/main.py config/default.py tests/__init__.py → echo "src/" > .gitignore（先占位，后续替换）。
立即学习“Python免费学习笔记（深入）”；
方法二：用Poetry初始化（推荐中大型项目）
终端中运行 poetry init -n → 手动编辑 pyproject.toml，在 [tool.poetry] 下补充 name = "my_project" 和 version = "0.1.0" → 运行 poetry env use ./venv/bin/python（macOS/Linux）或 poetry env use .\venv\Scripts\python.exe（Windows）绑定已建虚拟环境。
注意：Poetry默认会在项目根目录创建虚拟环境，必须强制指向已建的 ./venv，否则会生成第二个环境造成混乱。
配置核心文件与开发依赖
第一步：创建 pyproject.toml 的最小必需区块
在根目录新建 pyproject.toml，写入：
[build-system]
requires = ["setuptools>=45", "wheel"]
build-backend = "setuptools.build_meta"
[project]
name = "my_project"
version = "0.1.0"
requires-python = ">=3.9"
第二步：安装开发工具链
激活虚拟环境（Terminal中运行 source venv/bin/activate 或 venv\Scripts\activate）→ 依次执行：
pip install pytest pytest-cov black flake8 mypy isort → pip install -e ".[dev]"（若定义了 dev 依赖组）。
第三步：生成初始 .gitignore
访问 gitignore.io → 复制 Python + VSCode + macOS/Linux 模板 → 粘贴到项目根目录的 .gitignore 中 → 【务必手动追加 /venv/ 和 .env】，这是企业级项目安全底线。
验证环境与入口连通性
在 src/my_project/main.py 中写入：
def main():
print("Project initialized successfully.")
if __name__ == "__main__":
main()
回到终端，确保虚拟环境已激活 → 运行 cd src && python -m my_project.main → 若输出 Project initialized successfully.，说明包结构、导入路径、环境三者全部对齐。
此时不要运行任何测试或CI脚本——它们尚未配置。只需确认这行输出出现即可。
