在人工智能内容学习中，用Cursor从零开发Python项目全流程是常见主题。很多人在阅读时会遇到概念分散、步骤不清和注意点难以归纳的问题。本文按照基础概念、操作流程和关键细节，对相关内容进行整理。

用Cursor从零开发Python项目需完成五项核心操作：环境初始化（创建并选择.venv解释器）、代码编写（新建main.py并启用智能补全）、调试运行（配置launch.json、设断点、F5启动）、依赖管理（pip install或快捷修复安装并生成requirements.txt）、Git集成（初始化仓库、创建.gitignore忽略__pycache__和.venv、首次提交）。

用Cursor从零开发Python项目，需要完成环境初始化、代码编写、调试运行、依赖管理与Git集成五项核心操作，缺一不可。直接新建空白文件写代码会缺少虚拟环境隔离，导致后续依赖冲突；不配置调试器就无法单步追踪逻辑错误；忽略.gitignore会导致.pyc文件和__pycache__目录被误提交。

创建带虚拟环境的Python项目

打开Cursor → 点击左上角【File】→【New Folder】→ 输入项目名（如my_calculator）→ 回车确认。

在侧边栏右键新文件夹 → 选择【Open in Integrated Terminal】→ 执行：python -m venv .venv。这一步必须在项目根目录下运行，否则VS Code或Cursor无法自动识别环境。

终端执行完毕后，右下角状态栏会出现Python解释器提示 → 点击它 → 选择刚刚创建的【.venv/bin/python（Linux/macOS）或 .venvScriptspython.exe（Windows）】。选错解释器会导致后续pip安装包不进当前环境。

编写首个Python脚本并启用智能补全

在项目根目录右键 → 【New File】→ 命名为main.py → 输入print("Hello from Cursor")。

光标放在print右侧 → 按Ctrl+Space（Windows/Linux）或Cmd+Space（macOS）触发补全 → 选择print()函数签名 → 自动插入括号并高亮参数位置。Cursor此时已加载Python语言服务器，但若未激活正确解释器，补全将仅显示基础语法，不包含你安装的第三方库函数。

保存文件（Ctrl+S），此时文件名左侧出现圆点，表示未提交至Git——先别急着commit，等调试通过再做版本记录。

配置并运行调试器

点击左侧活动栏【Run and Debug】图标（虫子形状）→ 点击顶部蓝色链接【create a launch.json file】→ 选择环境为Python → 选择模板【Python File】。

Cursor自动生成.launch/launch.json文件 → 确保configurations数组中"program"字段值为"${file}"，这样每次F5都运行当前打开的.py文件，无需反复修改路径。

在main.py第1行左侧灰边区单击设置断点 → 按F5启动调试 → 终端切换至Debug Console → 程序暂停在断点处 → 查看Variables面板确认变量状态。如果断点未生效，检查右下角Python解释器是否指向.venv路径，而非系统全局Python。

安装与管理依赖包

方法一：终端内手动安装 在集成终端中执行：pip install requests → 安装完成后，Cursor会自动索引新包，requests.get()等函数即可获得类型提示与跳转支持。

方法二：光标悬停+快捷修复 在main.py中输入import requests → 若出现红色波浪线 → 将光标停在requests上 → 按Alt+Enter（Windows/Linux）或Option+Enter（macOS）→ 选择【Install package 'requests'】→ Cursor自动调用pip并刷新环境。

执行pip freeze > requirements.txt生成依赖快照。这一步必须在.venv激活状态下运行，否则导出的是全局环境包列表。

初始化Git仓库并忽略敏感文件

第一步：点击左侧Source Control图标（分支形状）→ 点击【Initialize Repository】→ 确认根目录路径无误 → 完成初始化。

第二步：右键项目根目录 → 【New File】→ 命名为.gitignore → 粘贴以下内容：

__pycache__/ .venv/ *.pyc .DS_Store .cursor/

第三步：在Source Control面板中勾选.gitignore → 输入提交信息“chore: init git and ignore rules” → 点击√按钮完成首次提交。注意【不要勾选.venv文件夹】，该目录体积大且含绝对路径，提交后会破坏他人环境一致性。