CodeBuddy支持跨文件安全重构：安装插件并重启VS Code后启用，选中符号右键选择“Refactor Symbol Across Files”，预览修改范围并确认应用，支持排除文件和禁用自动导入修正。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你需要在多个Python文件中统一修改函数名、类名或变量名，又不想手动逐个查找替换导致遗漏或误改时，CodeBuddy能自动识别语义上下文，安全完成跨文件批量重构。
安装并启用CodeBuddy插件
打开VS Code → 点击左侧扩展图标 → 搜索“CodeBuddy” → 点击“Install”按钮安装 → 安装完成后点击“Reload”重启编辑器。
重启后按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）唤出命令面板，输入“CodeBuddy: Enable”并回车启用。这一步不执行会导致后续所有重构操作不可见。
选中目标符号并触发跨文件重构
在任意一个.py文件中，将光标停在要重构的函数名、类名或模块级变量名上（例如calculate_total）→ 右键 → 选择“Refactor Symbol Across Files”。
CodeBuddy会自动扫描工作区中所有已打开的Python文件及python.defaultInterpreter所指向解释器路径下的import可达文件。它不会扫描未被导入的孤立文件，也不会进入venv或.git目录——这是默认行为，无需额外配置。
若光标未落在有效符号上（比如停在字符串内、注释里或空格处），菜单项会置灰不可选。此时请确认光标位置是否准确落在标识符内部。
预览并确认重构范围
触发后弹出侧边预览窗口，列出所有将被修改的文件路径及具体行号。每个条目右侧显示变更前→变更后对比。
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 问题
点击某一行可跳转至对应文件定位修改点；勾选左侧复选框可排除个别文件——【排除后该文件中的匹配项将完全跳过，且不可撤销】。
预览窗口底部有“Apply Refactor”按钮，点击即执行。此操作会直接写入磁盘，不经过撤回栈，务必在点击前确认勾选状态与预览内容无误。
自定义重构规则（可选）
方法一：通过设置JSON手动配置
按 Ctrl+, 打开设置 → 点击右上角“打开设置（JSON）”图标 → 在settings.json中添加：
"codeBuddy.refactor.excludePatterns": ["**/tests/**", "**/__pycache__/**"]
方法二：临时禁用某次重构的自动导入修正
在预览窗口中点击右上角齿轮图标 → 取消勾选“Update Import Statements” → 再点击“Apply Refactor”。这样可避免因重命名导致的import路径自动调整，适用于你打算手动维护导入逻辑的场景。
