ChatGPT旧代码整理：提示词必备限制条件

做技术文档转换这事儿，最头疼的不是代码本身有多复杂，而是ChatGPT总爱“自由发挥”。你把一段旧代码丢进去，它给你生成的说明要么漏掉了某个关键分支，要么凭空编出一个压根不存在的调用场景，更离谱的是，它还能把已经废弃的函数当成主流程来写。问题出在哪？提示词里缺了真正能管住它的硬约束，光靠一句“请写清楚”远远不够。

必须锁定输入源与输出边界

第一步：在提示词开头用【】明确圈出待处理代码块。比如这样写：

【

def legacy_calc(x, y):n    if x < 0:n        return Nonen    return x * y + 1

别小看这个分隔符，不加的话，模型很可能把你写的指令文字当成代码注释来理解，结果跑偏。

第二步：强制声明“仅基于【】内代码生成文档，禁止推测、补充、虚构任何未出现的变量名、函数调用或业务规则”。旧代码里经常有一些残缺逻辑，模型的本能反应就是“补全”，但这一句话能拦住九成以上的胡编乱造。

第三步：写明“若代码中存在明显语法错误或缺失定义（比如调用了未声明的func_a），须如实标注‘此处原始代码不可执行’，不得自行修复或绕过”。这不是可选项，是保真的底线。

格式与结构必须硬性嵌套

方法一：用字段级指令代替模糊要求。不要笼统地说“包含参数说明”，要具体到“参数说明字段必须列出每个形参名称、类型（从代码中推断）、是否可为空、在函数体内的首次使用位置（行号）”。

方法二：返回值部分必须区分“实际返回值”和“隐式返回值”。比如Python里没有return语句的函数实际返回None，你就得单独写一行：“隐式返回值：None（因末尾无return语句）”。【漏掉隐式返回值是旧代码文档最常见致命错误】

方法三：错误处理路径必须单列。只要代码里出现类似if xxx is None: raise ValueError(...)的结构，就要提取成“触发条件｜抛出异常类型｜异常消息关键词”三列表格，别用段落描述糊弄过去。

禁用一切泛化表达

禁止使用“通常”“一般情况下”“可能涉及”这类模糊限定词。所有陈述必须能追溯到代码字面。比如不能说“该函数通常用于数值计算”，而要写成“该函数仅在main.py第42行被调用，传入参数来自user_input.get_int()”。

禁止添加背景解释。千万不要写“由于历史原因，该函数未使用类型提示”，只允许写“代码中无类型注解”。【加解释=开脑补口子】

每项说明后面必须附带原始代码行引用，格式为[Ln12-15]。没有引用行号的内容一律视为无效输出。