用Cursor可快速理解Python项目：先看README.md等5个关键文件，再通过启动脚本、配置文件或AI命令定位入口，结合测试命名、文件解释和依赖分析明确模块职责与环境，最后生成结构图谱可视化依赖关系。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想快速看懂一个陌生的Python项目，又不想逐个点开每个文件猜用途，用Cursor能直接透视项目骨架、定位核心模块、识别依赖关系，省去手动翻查的时间。
打开项目后第一眼看到什么
启动Cursor → 打开已有Python项目文件夹（File → Open Folder）→ 左侧资源管理器自动展开目录树。此时不要急着点文件，先盯住根目录下这5个关键文件：README.md、requirements.txt、pyproject.toml、src/（或同名包目录）、tests/。
如果项目没用src布局，而是直接以my_project/为包名，那根目录下第一个带__init__.py的文件夹就是主包——【这是所有业务逻辑的起点，跳过它等于没看懂项目】。
三步定位核心代码入口
方法一：查启动脚本
立即学习“Python免费学习笔记（深入）”；
在资源管理器中搜索main.py、app.py、run.py或cli.py → 找到后右键→“Open in Terminal” → 输入python xxx.py观察报错或输出，确认是否为真实入口。
方法二：看配置文件线索
打开pyproject.toml → 查[project.scripts]或[tool.setuptools.entry-points."console_scripts"]段 → 找形如"start = 'my_package.cli:main'"的行 → 这说明入口函数在my_package/cli.py的main()里。
方法三：用AI直接问
选中整个项目根目录 → 按Cmd/Ctrl+L唤出AI命令栏 → 输入：“这个项目的主程序入口在哪？请指出文件路径和函数名” → Cursor会扫描setup.py、pyproject.toml、__main__.py等位置给出精准答案。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
快速识别模块职责
第一步：右键点击src/（或主包名）→ “Find in Files” → 搜索import requests、import pandas、import flask等高频库 → 出现次数最多的文件大概率是数据处理或API交互核心。
第二步：打开tests/目录 → 观察test_开头的文件命名 → test_api.py对应api/模块，test_preprocessing.py对应data/或utils/preprocessing.py → 【测试文件名是模块功能最诚实的说明书】。
第三步：选中任意.py文件 → 按Cmd/Ctrl+K → 输入“explain this file” → Cursor会生成该文件职责摘要，包括输入输出、调用关系、关键类作用。
依赖与环境一眼判别
打开requirements.txt → 快速扫视前三行：requests、numpy、pandas出现即偏向数据项目；flask、fastapi、uvicorn出现即Web服务；pytest、mypy、black出现则说明有规范约束。
若只有pyproject.toml没有requirements.txt → 点击文件 → 展开[project.dependencies] → 这里才是真实依赖清单，旧版pip freeze生成的txt可能已过期。
终端执行which python → 看路径是否含venv或.env → 如果是系统Python路径，【立刻停止运行任何代码，先建虚拟环境】，否则依赖冲突风险极高。
结构图谱一键生成
确保项目已加载 → 按Cmd/Ctrl+Shift+P → 输入“Project: Generate Structure Diagram” → 回车 → Cursor自动分析import链，生成带箭头的模块依赖图。
图中红色节点是入口文件，蓝色节点是被多处引用的工具模块，灰色节点是测试或配置文件——鼠标悬停可查看该模块被哪些文件import。
生成后点击图中任意模块 → 右侧AI面板自动弹出该模块的职责解释和典型使用场景。
