01「中文版代码审查提示词」到底在问什么
「中文版代码审查提示词」的答案往往取决于两件事:你手上有多少信息,以及你允许自己改几轮。这两项不同,写法就不同。在编程开发这一类任务里,能复现的写法比一次性的妙手更有价值。
先分清「想要什么」和「不要什么」。多数人只写前者,于是模型按平均值给答案,看起来都对,实际都用不上。
下面这份内容按「示例 → 字段 → 场景 → 错误 → 验收」排,你可以从任意一节开始看;如果只想马上用,直接跳到第二节复制那段提示词。
代码类需求要写明运行环境:语言版本、依赖、输入输出样例。「中文版代码审查提示词」不写这些,出来的代码往往看着对、跑不通。
还有一个习惯值得养成:要求它把边界情况单列出来,比如空值、超长输入、并发。这些地方才是真正会出事的地方。
02三种写法,差别在哪
三种写法放在一起对比,最容易看出问题:多数人卡在第一行,以为多写几句客套话就叫说清楚了。
| 常见写法 | 为什么效果差 | 改成这样 |
|---|---|---|
| 「写个函数实现中文版代码审查提示词」 | 得到一段能跑但没处理边界的代码 | 「写一个函数,输入是××,需处理空值、超长、并发三种情况」 |
| 「这段代码报错了怎么办」 | 没有上下文,回答只能是猜测 | 「报错信息:……,相关代码:……,运行环境:……,请定位原因」 |
| 「优化一下性能」 | 不知道瓶颈在哪,优化往往是猜测 | 「这段代码在 10 万条数据下变慢,请先分析瓶颈再给方案」 |
03一条能直接用的示例
先跑这一版。它把最容易漏的三项(背景、约束、格式)都写进去了,多数情况下比一句话需求好一个档次。
你是工程经验丰富的开发者。
【任务】围绕「中文版代码审查提示词」,给我可以直接运行的代码。
【要求】写清运行环境和依赖版本;给出输入输出示例;说明时间复杂度和可能的失败输入。
【约束】不要伪代码;不要省略错误处理;不确定的库版本标出来。
【格式】先给完整代码,再给三行以内的说明,最后列出已知限制。04要加强版就加这两步
加强版的关键不在更长,而在多了「自检」这一步。让它在输出后指出自己哪里没把握,比你事后逐句核对快得多。
你是做代码评审的资深工程师,需要为「中文版代码审查提示词」产出一段能直接用的实现。
【任务】写代码,并把边界说清。
【要求】
1. 先说明输入假设和输出约定(类型、空值、异常);
2. 给出完整可运行的实现,不要省略号;
3. 列出至少四个边界情况,并说明代码里怎么处理;
4. 说明这段代码在什么规模下会出问题(时间复杂度或内存)。
【约束】不引入未说明的第三方依赖;不使用「这里省略」;变量名要能自解释。
【格式】先说明,再代码,最后边界表。05字段怎么填
这张表的作用是查漏:写完提示词后逐行对一遍,缺哪行就补哪行,比反复重写整段省时间。
| 字段 | 怎么写 | 常见反例 |
|---|---|---|
| 环境 | 语言版本、依赖、运行方式 | 「在你的环境里跑一下」 |
| 边界 | 空值、超长输入、并发怎么处理 | 只写正常路径 |
| 限制 | 在什么数据量下会变慢或出错 | 声称适用于所有场景 |
| 输入约定 | 类型、空值、长度上限,写清 | 假设输入永远合法 |
| 错误处理 | 说明失败时返回什么、抛什么 | 只写正常路径 |
| 可运行性 | 要求完整代码,不留省略号 | 接受伪代码 |
06换场景,侧重就不一样
同一个词,用在不同场合要调的地方不同。下面四种场景覆盖多数情况,按你实际的场合挑一行看就行。
| 场景 | 这种场合下要侧重什么 |
|---|---|
| 写新功能 | 先定接口再写实现,避免返工 |
| 改老代码 | 先让模型读现有代码,再提改动方案 |
| 排查报错 | 给完整错误栈和相关代码,别只给一句报错 |
| 写测试 | 先让它列用例,再实现,覆盖率高很多 |
07六个常见错误
- 不说明版本,代码在别人机器上直接报错。
- 只给正常路径,一遇空值就崩。
- 拿它生成的代码直接上生产,没有测试也没有 review。
- 让它「优化性能」但不说数据规模,改完反而更慢。
- 直接复制没跑过的代码,边界一碰就崩。
- 让模型解释报错,却不给完整错误信息和上下文。
08怎么判断这次输出能不能用
判断标准要能自检,不能靠感觉。下面四条都是你自己就能确认的,不需要别人帮忙看。
09三个让它更稳的做法
10三种不满,三种改法
下面这张表反过来用:先说你哪里不满意,再找对应的那一行去改。比从第一条要求往下读快。
| 你现在的感觉 | 该动哪一行 | 改完会怎样 |
|---|---|---|
| 看着都对,但一句都用不上 | 任务行把「帮我写」换成「交什么、给谁看、多少字」 | 从正确的废话变成能直接用,第一版就够改 |
| 内容太满,重点被埋了 | 任务行要求先给一句话结论,再展开三点 | 结论先行,扫一眼就能拿走 |
| 分不清哪句是它编的 | 约束行写「没有依据的地方标待核实,不许补数字」 | 可疑处浮出来,你只核那几处 |
11换个模型,要调什么
不必为每个模型重写一套。多数情况只需要动一行,剩下的是同一套结构。
| 模型 | 常见差异 | 调整一处 |
|---|---|---|
| 豆包 | 口语化,短内容出得快 | 先用它出草稿,再交给长文模型润 |
| Claude | 长文和改写更稳,但句子容易绕 | 加一条「每句不超过 30 字,能删就删」 |
| Midjourney | 参数决定画幅和风格力度 | 主体写最前面,参数单独放最后一行 |
| 文心一言 | 中文语感顺,遇到敏感话题会自我收窄 | 把要求拆小,一次只问一件事 |
12从空白到能交:五步走完
第一次走完大约二十分钟,之后同类任务只需要三分钟,因为结构已经固定了。
- 先定读者:他是谁、关心什么、最怕看到什么。
- 再定形态:文档、表格、清单,还是一条能直接发出去的消息。
- 给一个反例,写「不要写成这样」,比十条正面要求管用。
- 要求它自评:哪一段最弱,为什么。
- 只改它自评最弱的那一段,其余保留,别整篇重写。
13常被追问的四件事
这些是实际操作里最常被问到的,不涉及原理,只讲怎么处理。
加一句:没有依据的数字写「待核实」,不许估算。然后把待核实项逐条自己查。
各家对「简洁」「专业」的默认理解不同。把要求写成能检验的条件,比如字数、段落数、禁用词,差异会小很多。
事实、数字、引用、法规条款必须自己核;表达可以直接用。涉及合同、医疗、法律的内容,只当草稿。
不需要。把跑通的那版存下来,下次只替换主体信息。变化的是内容,不是结构。
14这套写法什么时候不管用
这套写法有边界。下面几种情况用了也不会有好结果,提前知道能省时间。
| 情况 | 为什么不管用 |
|---|---|
| 内容要过平台审核 | 各家规则不同而且一直在变,提示词保证不了过审。发布前按平台最新的社区规范自己过一遍。 |
| 要用到没公开的内部信息 | 客户名单、未发布方案别直接贴进去。需要的那部分改写成抽象描述,模型照样能给结构。 |
| 任务本身还没想清 | 你自己还没决定要什么的时候,写再多提示词也只是把模糊往后推一步。先定交付物。 |
FAQ常见问题
「中文版代码审查提示词」生成的代码能直接用吗?
小工具可以,生产代码不行。至少要做三件事:跑通边界用例、看依赖是否安全、确认没有硬编码的密钥。
怎么让它少出错?
给具体的输入输出示例,比写十句「注意健壮性」有效。再补一句「不确定的库版本标注出来」。
需要会编程才能用吗?
要能读懂报错。完全不看代码就上线,出问题时你无法判断是逻辑错还是环境错。
AI 写的代码能直接用吗?
小片段可以用,进生产前必须过测试。重点检查空值、越界、并发和异常吞掉这四类问题,它们最容易漏。
为什么不给完整代码,它总写省略号?
因为提示词里没要求完整。加一句「不要省略,给出可直接运行的完整代码」,命中率会明显提高。
怎么让它理解我的项目?
把相关的目录结构、接口定义、已有实现贴给它。它对上下文的理解完全依赖你给的信息,不给就只能按通用写法来。
→同类关键词
这些词和本页属于同一类,字段结构基本相同,换个词就能复用。