返回博客

我在FastAPI项目里怎么用提示词让Copilot写出能跑的登录接口

2026/9/93 分钟阅读
我在FastAPI项目里怎么用提示词让Copilot写出能跑的登录接口

我在FastAPI项目里怎么用提示词让Copilot写出能跑的登录接口

说实话,一开始我挺失望的。第一次让Copilot写登录接口,它甩给我一段JWT认证代码——看着挺专业对吧?但跑起来直接报错,密钥轮换根本没配。

"写个FastAPI登录接口。"就这八个字,结果差了十万八千里。

AI 辅助开发 - 插图 1

后来我折腾了很久,终于摸清门道:AI不是不懂,是你没说清楚。

提示词从模糊到精准:摔过的跤

很多人觉得AI辅助开发就是多问几句。错。

我第一次尝试结构化提示词时,是在写一个金融项目的用户认证模块。之前我试过直接丢需求,结果生成的代码要么风格怪异,要么完全不符合内部规范(别信它说的‘已兼容Python 3.12’——我本地报错)。

现在我的提示词会包含这些元素,但不是列清单,而是写在上下文里:

"你是个在金融项目里干了5年的Python工程师,所有token必须支持热替换。用FastAPI框架,接PostgreSQL,代码符合PEP 8并加类型注解。参考这段类似功能的代码作为风格示例..."

这么一改,成功率直线上升。

简单任务我保持简洁,复杂任务我就详细展开步骤。上周让AI补三个API,提示词写得细,它生成的代码直接能跑通核心逻辑——虽然多花了20分钟修它漏掉的异常分支。

工具链配置:我踩过的坑

我用过GitHub Copilot、Cursor,也试过命令行助手。

在VS Code里配Copilot时,我特别注意环境变量安全。有些同学喜欢把API Key写进项目设置里共享,千万别这样——我在公司就见过同事手滑推上去,差点炸锅。

我在 .vscode/settings.json 里自定义了补全行为,禁掉了一些低频语言的提示。不然写Python时,JavaScript的代码建议老跳出来,烦得很。

每次接受建议前,我一定先建分支,用git diff预览变更。AI生成代码可以快,但版本追溯不能省。

代码审查:别偷懒

AI会骗你。

它生成的代码看起来逻辑通顺,但可能藏着SQL注入漏洞,或者硬编码密钥。我审查时重点看三点:逻辑一致性、安全性、性能瓶颈。

有个同事直接复制AI代码进生产环境,没测。结果线上出bug,查了半天才发现是AI漏掉了边界条件。

现在我养成了习惯:生成→测试→审查。

先用最小化示例验证核心功能,再通过pytest跑一遍,最后让静态分析工具扫一下。这套流程下来,虽然比纯AI生成慢了,但比手写+调试快了——上周补三个API,手写要4小时,AI辅助后本地跑通核心逻辑用了1.5小时。

代价是:你得花更多时间review,得教AI你想要的风格,得接受它偶尔犯蠢。

现在卡在让AI理解我们自研的权限中间件——它总把@require_role()当成装饰器语法错误,怎么提示都不对。

原文出处

本文首发于 我在FastAPI项目里怎么用提示词让Copilot写出能跑的登录接口 — https://lyxq.com.cn/zh/blog/ai-assisted-development-practice

转载或引用请注明出处,商业使用请联系作者获得授权。