CodeBuddy提供五种JavaScript/Java长函数重构方法：一、按语义提取私有函数；二、按职责切分为模块化函数组；三、递归转显式迭代并外提处理逻辑；四、依复用性识别并提取公共函数；五、基于JSDoc注释驱动结构化拆分。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 CodeBuddy 处理 JavaScript 或 Java 等语言的代码时，发现某个函数长度超过 80 行、嵌套层级深、职责不单一（如同时处理数据校验、转换、组装与异常兜底），则可能是由于函数边界模糊、复用性差或测试覆盖困难所致。以下是针对该问题的多种重构方法：
一、按语义提取独立私有函数
该方法识别原函数中具有明确业务含义的逻辑块（如“解析用户输入”“生成订单摘要”“校验库存状态”），将其封装为命名清晰、参数精简的私有函数，使主函数退化为高阶协调者，显著提升可读性与单元测试可行性。
1、在 VS Code 中打开目标文件（如 src/services/order.js），选中待拆分的长函数体。
2、右键调出 CodeBuddy 快捷菜单，点击【Extract Semantic Function】。
3、CodeBuddy 自动分析控制流与变量依赖，弹出候选切分点列表（例如：_validateOrderInput、_buildOrderSummary、_checkInventory）。
4、勾选需提取的逻辑块，确认后 CodeBuddy 在原函数上方插入对应私有函数，并将原位置替换为调用语句，同时移除未被引用的中间变量。
二、基于职责边界自动切分为模块化函数组
该方法适用于函数内部存在多个松耦合子流程（如“预处理→核心计算→后置清理→结果包装”），CodeBuddy 根据数据流向与副作用范围划分职责域，生成一组协作函数，每个函数仅暴露必要输入输出，消除隐式状态传递。
1、在 CodeBuddy 指令框中输入：Split calculateReport() in src/analyzer.js into role-based functions: preprocessing, calculation, formatting, error handling。
2、CodeBuddy 启动【Craft Mode】，扫描函数内所有 if/for/try 块及外部依赖，标记各段落的输入源与输出目标。
3、生成四个新函数：preprocessRawData()（纯函数，无副作用）、executeCoreCalculation()（接收预处理结果，返回原始数值）、formatResultForDisplay()（仅操作字符串与对象结构）、handleCalculationFailure()（统一捕获并构造错误响应）。
4、原函数重命名为 calculateReport()，内容简化为四步顺序调用，并添加 JSDoc 注明各环节契约。
三、递归逻辑外提并转为显式迭代结构
该方法专用于含深度递归的长函数（如树遍历、嵌套对象展开），通过剥离递归调用链，改用数组栈管理遍历状态，既消除栈溢出风险，又使每层处理逻辑独立成函数，便于调试与性能观测。
1、定位含 return traverse(node.children) 或 traverse(child) 的递归函数。
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
2、向 CodeBuddy 提交指令：Convert recursive traverse() to iterative version with explicit stack, then extract node processing logic into _processSingleNode()。
3、CodeBuddy 生成两个函数：traverseIterative()（含初始化栈、while 循环、子节点压栈逻辑）与 _processSingleNode()（接收单个 node 参数，执行原递归体内的非递归部分）。
4、检查 _processSingleNode() 是否仍含条件分支递归调用；若存在，CodeBuddy 将提示进一步拆分其内部逻辑块。
四、依据调用频次与复用潜力识别可提取公共函数
该方法利用 CodeBuddy 的跨文件索引能力，扫描当前项目中所有相似逻辑片段（如多处出现的日期格式化、URL 参数拼接、对象深克隆），将高频重复代码抽离为独立导出函数，并在原长函数中替换为调用，同步更新所有引用点。
1、在 CodeBuddy 主界面启用【Project Insight】功能，选择【Find Duplicate Logic】。
2、系统高亮显示长函数中与 src/utils/date.js#formatISODate 或 src/lib/urlBuilder.js#buildQueryParams 行为一致的代码段。
3、点击高亮区域旁的【Extract & Replace】按钮，CodeBuddy 自动将该段逻辑迁移至对应工具文件，并在长函数中插入 import 语句与函数调用。
4、确认变更后，CodeBuddy 运行轻量级影响分析，确保所有被替换位置的参数类型与返回值兼容原上下文。
五、结合 JSDoc 注释驱动的结构化拆分
该方法要求长函数顶部已存在完整 JSDoc，CodeBuddy 解析 @param、@returns、@throws 及自然语言描述，反向推导函数应具备的输入预处理、主干执行、结果校验、错误映射等环节，据此生成带语义标签的函数骨架。
1、确保待拆分函数头部包含符合 JSDoc 规范的注释，例如明确列出 @param {Object} config - 包含 timeout 和 retryStrategy 与 @returns {Promise<Result>} - 成功时返回标准化结果对象。
2、右键函数名，选择【Refactor by JSDoc】。
3、CodeBuddy 解析注释后生成五个函数：_validateConfigShape()、_normalizeConfigDefaults()、_executeWithRetry()、_mapToResultObject()、_translateErrorToResult()。
4、每个生成函数均自动携带与其职责匹配的 JSDoc 子集，且参数签名严格遵循原始注释声明的类型与约束。
