Codeium代码重构提示词生成实战指南

Codeium重构提示词必须结构清晰：先声明Python 3.11、pandas 2.2.2、pydantic v2.7环境；再用三段式指令明确分析依赖、纯函数化改造、输出合规代码；最后绑定Black格式、嵌套深度≤3、函数≤45行等项目规范。

你需要让Codeium生成的代码重构提示词，一提交就能直接产出可运行、无语法错误、符合当前项目规范的代码，而不是反复调试、手动补全类型、再花十分钟修缩进和空格——关键在于把重构意图拆解成Codeium能精准响应的结构化指令，同时绑定真实上下文。

锁定重构目标并注入真实代码上下文

打开VS Code，确保待重构的Python文件已保存（比如data_processor.py），并且光标位于需要改造的函数内部，或者紧邻其上方空行。务必选中原始函数的完整定义——也就是包含def行、docstring和所有逻辑行的整个块。只选几行是不行的，因为Codeium如果缺少函数签名或return语句，会误判返回类型，最终生成的代码很可能通不过mypy校验。

右键点击，选择“Codeium: Generate Text”，在弹出输入框后，第一句话必须明确当前环境：“你正在重构一个使用Python 3.11、依赖pandas 2.2.2和pydantic v2.7的ETL处理模块。”

这不是客套话。它强制Codeium加载对应版本的类型推断规则——举个例子，pydantic v2.7要求BaseModel字段的默认值用Field(default_factory=list)而不是[]。这一点必须说清楚，否则漏掉版本号，生成的语法可能直接跑不通。

用三段式指令明确重构契约

环境声明之后，立即写入以下结构（标点、换行、空格都不要改动）：

“请执行以下三步操作：
① 先分析原函数中所有外部依赖调用（如pd.read_csv、requests.get），列出它们的返回类型与可能异常；
② 再将函数重构成纯函数：移除所有全局变量引用、拆分IO操作为独立参数、用typing.Union标注所有可为空的返回路径；
③ 最后输出完整重写后的函数代码，要求：保留原函数名、保持原有docstring不变、每行不超过90字符、禁用any类型、所有新引入的类必须带__slots__。”

这三步不能合并。第一步确保Codeium不会凭空假设依赖行为；第二步彻底封死副作用泄漏的可能；第三步用硬性格式约束规避团队CI失败——比如之前有一次重构，就因为用了def process_data(...) -> dict:就被pre-commit拒绝了，原因就是没写成Dict[str, Any]。

绑定项目级规范防止风格漂移

在指令末尾追加一行项目专属规则：

“本项目强制执行Black格式化，所有if/for块内嵌套深度≤3，函数体长度≤45行，若重构后超限，请自动拆分为helper函数并导出到同一模块。”

这句话必须写上。Codeium默认倾向把逻辑全塞进一个函数里，而实际项目中，超过30行的函数就会被sonarqube标为“高复杂度”。加上这条限制，它会主动拆分解耦，而且拆分出来的helper函数命名会带上_internal后缀——这也符合你们团队对私有函数的命名约定。

按下回车提交，Codeium输出的代码可以直接复制进文件，不需要再手动调整缩进、补类型注解或删除调试用的print语句。