Gemini代码学习计划提示词怎么加入真实场景

先说说背景。我带了4个实习生，发现一个普遍问题：刚转行的学员，自认为“会爬虫”就觉得自己能直接上手一个Web后端项目。实际上，从抓网页到写API之间，隔着一条巨大的鸿沟——Django这个框架。要是按教科书路径走，学变量、学循环、学函数，两周时间绝对不够用。所以我设计了一个针对性的速成计划，目标非常明确：让你在14天内，拿出3个能摸得着、能给别人看的东西。

锁定真实开发角色与交付物

计划的第一步，是先把身份和产出目标钉死。你是一位Python后端工程师，刚转行、已会写简单爬虫但没碰过Django的学员。你的任务不是“学Django”，而是“用Django做出一个能跑通的订单API”。这就是核心区别。

紧接着，要强制绑定三个可验证的交付物：

① 一个能跑通的订单API（含POST创建+GET查询，用Postman截图证明status=201）。
② 一份详细的debug记录（贴出manage.py runserver时报错的完整终端输出，以及你删掉哪行代码后恢复的过程）。
③ 一张Git commit图谱，显示至少3次有效commit，每次message必须包含“fix”或“add”。

注意，这一步不能跳。

嵌入具体开发环境与故障线索

接下来说怎么让计划落地。不是列一堆操作步骤，而是直接模拟真实开发中会遇到的故障。

方法一：把真实的终端报错日志写进计划里。比如，学员在执行python manage.py migrate时，报了这个错：

django.core.exceptions.ImproperlyConfigured: Requested setting DATABASES, but settings are not configured. You must either define the environment variable DJANGO_SETTINGS_MODULE or call settings.configure() before accessing settings.

这个错误很经典，说明学员可能没正确设置DJANGO_SETTINGS_MODULE，或者settings.py文件本身找不到。

方法二：绑定IDE操作路径。比如写明：“学员正在用PyCharm打开一个已clone的仓库，当前文件是settings.py第12行，光标停在DEBUG = True后面，旁边terminal标签页显示刚才的migrate报错。”这样一来，学员知道从哪里入手排查。

方法三：注入物理环境限制。“学员笔记本是2024款MacBook Air（8GB内存），装了Homebrew但没配conda，虚拟环境必须用venv且路径不能含中文。”这个细节很重要，很多新手在配环境时卡在中文路径上，提示词里提前点明，能避免大量无效尝试。

按真实排障节奏组织学习步骤

现在，把上面的故障线索串起来，组织成排障步骤，而不是教学大纲。

第一步：从报错现场切入。先查manage.py所在目录的__init__.py是否为空。很多新手漏了这一步，导致Django找不到应用。

第二步：确认settings.py的位置。打开终端，输入pwd，对比INSTALLED_APPS里写的app名和实际文件夹名是否大小写一致。比如，写了'Users'但文件夹是'users'，这就对不上。

第三步：修复后运行python manage.py check。如果提示“No issues found”，说明配置层通关了。如果还报错，跳到第四步，查DATABASES字典是否被注释掉。

第四步：把DATABASES配置复制粘贴进settings.py。注意：贴完后要检查末尾逗号，Python有时会因为多余逗号报语法错误。然后，再试一次migrate。

这几步逻辑很简单，不要解释太多原理，直接复制进提示词就行。

植入团队协作痕迹与工具链依赖

最后，要让计划看起来像是在真实的公司环境里执行的。在提示词末尾加上这么一句：

“该计划必须基于公司内部已部署的Notion模板（ID: NT-DJ-2026-Q2）填写每日进度，且所有代码提交前需在Figma组件库（链接: https://figma.com/file/django-api-v26）中核对字段命名规范。”

光是写“参考文档”还不够。要具体到：“打开Notion模板第3页的‘字段映射表’，对照order_id字段是否应为snake_case而非camelCase”——