借助Cursor，大约5分钟就能自动生成一个结构清晰、基础配置完整的 Python 项目骨架：目录会自动创建，pyproject.toml（内置 black、isort、pytest 配置）、README.md、.gitignore 等常用文件也会同时生成，还能顺带完成虚拟环境关联、依赖安装以及 Git 初始化。

如果你想在5分钟内快速新建一个结构规范、带基础配置的 Python 项目，无需手动创建目录、编写 pyproject.toml、执行 git init，直接通过 Cursor 就能自动完成整套 Python 项目骨架搭建流程。

安装并配置Cursor支持Python开发

先打开Cursor官网下载安装最新版客户端，安装完成后首次启动时勾选“Add to PATH”选项，确保终端可以直接调用 cursor 命令；如果已经安装但终端无法识别，则需要手动将 Cursor 安装目录中的 bin（macOS/Linux）或 resources/app/bin（Windows）路径加入系统环境变量。

在Cursor中按 Cmd+Shift+P（macOS）或 Ctrl+Shift+P（Windows/Linux），输入“Settings: Open Settings (JSON)”，然后在打开的 settings.json 末尾添加：
"python.defaultInterpreterPath": "./venv/bin/python"（macOS/Linux）或"python.defaultInterpreterPath": ".\venv\Scripts\python.exe"（Windows），这样可以让后续自动生成的 Python 项目默认关联虚拟环境解释器路径。

用AI指令一键生成完整项目结构

新建一个空白文件夹，在Cursor中使用 Cmd+K（macOS）或 Ctrl+K（Windows/Linux）打开命令面板，输入“New Chat”，再在对话框中输入下面的指令：

方法一：精准结构指令
“生成一个标准Python项目骨架，包含src/、tests/、docs/目录；src下有__init__.py和main.py；根目录含pyproject.toml（使用poetry风格）、README.md、.gitignore（Python模板）、.pre-commit-config.yaml；要求pyproject.toml中预置black、isort、pytest配置。”

方法二：类比式指令
“参照fastapi最新项目结构，但去掉uvicorn依赖，换成httpx和rich，生成对应骨架。”

【一定要等AI内容全部输出完成后再进行下一步操作，中途关闭窗口或中断生成，可能会导致项目文件和目录丢失】

执行生成并验证目录完整性

第一步：点击AI回复末尾的“Apply”按钮，Cursor 会自动在当前文件夹中创建所需的全部目录和文件。

第二步：右键任意生成的.py文件→“Python: Select Interpreter”→选择“Enter interpreter path”→定位到刚生成的./venv/bin/python（macOS/Linux）或.venvScriptspython.exe（Windows）。

第三步：打开内置终端后，先执行poetry install（如果pyproject.toml中使用的是 poetry 配置），或者执行pip install -e .（如果项目基于 setuptools 方案），重点确认安装过程中没有出现依赖解析错误。如果报出“ModuleNotFoundError: No module named 'toml'”，通常可以判断是pyproject.toml中未声明build-system.requires，这时需要手动补充["setuptools>=45", "wheel", "setuptools-toml"]。

第四步：执行git status，检查新生成的文件是否都已被自动跟踪，同时确认 .gitignore 是否正确忽略 __pycache__、*.pyc、venv/ 等常见缓存和虚拟环境目录。