Gemini重构函数提示词编写指南：保持输入输出不变

要让Gemini精准重构函数，同时彻底锁定输入接口与输出格式，操作门槛其实集中在提示词的严谨度上。很多人反复尝试后发现，即便明确写了“保持逻辑不变”，最终生成的代码依然会擅自改变调用方式，导致大量调试成本。根据我们处理的真实案例，症结只有一个：你给的约束条件，没有把边界彻底焊死。

要让Gemini严格“拷贝”函数的输入输出行为，必须在提示词里把接口契约全部封死：禁止任何语义变通，排除隐性副作用，同时明确拒绝自作主张的“优化”。

固定函数签名与IO规约

提示词开头就得把底线列清楚：“你只能改动函数内部实现，绝不允许改函数名、参数名、参数顺序、参数类型（含可选参数和默认值）、返回值类型、返回值结构（例如究竟是返回Promise还是嵌套数组），以及空值和异常的处理方式”。

这一项只要漏掉任意一条，后果就很严重。Gemini完全可能把 async function 替换成同步调用，或者把原始的 {data, error} 结构直接换成 throw new Error()，调用方逻辑就会全线崩塌。

严禁一切语义等价替换

这个陷阱中招的人最多。很多人觉得结果一样无所谓，但这恰恰是最致命的坑。必须明确告知模型：“不允许用 Array.from(set) 替换 [...new Set(arr)]，不允许用 str.trim() 替换 str.replace(/^\s+|\s+$/g, '')，更不能把 for 循环硬改成 reduce——即使计算结果完全相同也不行。因为执行路径、错误堆栈生成机制、性能特征和内存占用都可能存在差异”。

两种方式能把这条规则落地：

方式一：追加约束句「所有变量名、中间计算步骤、分支逻辑顺序必须与原代码保持一致，唯一允许调整的是缩进、空行、括号位置，以及拆解过长的表达式」。

方式二：让Gemini先输出一份“本函数当前输入输出契约摘要”，确认无误后才允许动手重构。摘要必须包含：入参的样例值（包括边界值，比如 null/undefined/NaN）、预期返回值的类型和结构，以及已知可能抛出的错误类型与触发条件。

强制阻断副作用与外部依赖

这是一个容易被忽略的关键环节。需要加入硬性指令：“如果原函数中调用了 console.log、localStorage、Date.now()、Math.random()、fetch 或任何全局变量，必须原封不动保留调用位置和参数；不得封装、提取、mock、删除，也不得新增任何外部调用”。

【核心前提】 提示词里必须附带完整的原始函数代码（注释也要保留），并明确标注「以下代码为不可变更的基准版本」。

这一步如果缺失，Gemini会默认帮你“清理日志”或“把随机数换成常量”，你的测试用例会全部失效，后果可想而知。

验证重构结果的最小必要步骤

重构不是终点，验证才是。可以把验证流程拆成三步，嵌入提示词：

第一步：要求Gemini输出“重构后的代码”外加一份“逐行差异说明”。差异说明中每一条都必须标注“是否影响输入输出行为”，并给出判断依据。

第二步：让Gemini列出“三个最可能破坏兼容性的风险点”。例如：“第12行把 a == b 改成了 a === b，当 a 是 '0'、b 是 0 时，返回值会从 true 变成 false”。

第三步：要求Gemini在重构后的代码末尾补充一行注释：// REFACTORED: input/output identical to v1.0.3 —— 这行注释必须与原始代码中标注的版本保持一致。

来源：互联网