在 Ja va 或 TypeScript 这类大型项目开发中，常需要将某个被多处引用的变量名（例如 userList）统一改为 users。如果依靠手动逐个查找替换，很容易遗漏、误改，甚至破坏引用关系。通义灵码能够基于项目级上下文，精准识别所有有效引用点，安全完成跨文件批量重命名。下面直接介绍操作流程，并附带实战中的注意事项。
正式操作前，务必确认一个前提：变量已被 IDE 正确解析并建立符号索引。否则后续所有工作都是徒劳。
确认变量作用域与引用范围
打开包含目标变量的源文件（例如 UserService.ja va），将光标停在待重命名的变量上——比如 private List 中的 userList。关键前提：变量在当前项目中必须已被正确解析。如果变量名下方出现红色波浪线或 IDE 未识别其类型，通义灵码就无法准确定位全部引用。
同时观察右侧编辑器边缘，是否显示了灰色引用计数（例如“3 references”）。如果有，说明 IDE 已经建立了符号索引；如果没有，先执行 Build → Rebuild Project，否则后续重命名很可能会遗漏文件。
这两个步骤虽然基础，但实际开发中很多人会跳过，结果后续频频报错，排查起来反而更耗时。
触发通义灵码智能重命名
触发方式有两种，推荐使用快捷键，操作更加顺手。
方法一：快捷键触发（推荐）
保持光标位于变量名内部，按下 Ctrl+Shift+Alt+R（Windows/Linux）或 Cmd+Shift+Option+R（macOS），弹出重命名对话框后，输入新名称（例如 users），直接回车确认。
方法二：右键菜单触发
也可以右键单击变量名，在上下文菜单中选择 Refactor → Rename with Tongyi Lingma。同样输入新名称，点击 Preview 预览所有将被修改的位置，确认无误后再点击 Do Refactor 执行。
两种方式效果相同，可根据个人习惯选择。快捷键适合高频操作，右键菜单适合偶尔使用，并且多了一个预览步骤，让人心里更有底。
验证并提交修改
重命名并非按个回车就结束，后续的验证和提交才是决定成败的关键环节。
第一步：检查预览窗口。这里有一个容易被忽视的细节：预览窗口会列出所有将被修改的文件路径，特别留意是否包含了 src/api/xxx.ts、src/utils/dateHelper.js 这类非 Ja va 文件。在前后端混编的全栈项目中，通义灵码会自动识别跨语言调用，但反过来也需要你确认 JS/TS 里的引用是否合理——例如 Ja va 里是驼峰命名，JS 里却用了下划线写法，这种不一致的情况需要手动调整。
第二步：注释替换要谨慎。关于 Search in comments and strings 这个选项：默认是不勾选的，但如果你特意勾选了，通义灵码会把注释里所有出现 userList 的地方一并替换。这可能导致文档描述失真——比如一段注释原本写的是“userList 代表用户列表”，改完后可能变得难以理解。除非你确实打算同步更新文档注释，否则建议保持默认，不勾选。
第三步：执行后立即验证。点击 Refactor 后，等待状态栏提示“Refactoring completed”。然后立刻运行单元测试（如果有的话），或者启动服务跑一遍业务流程。如果某处突然报错“No such field”，说明那个引用没有被通义灵码识别，需要手动修复——这种情况在非主流框架或自定义注解场景下偶尔会发生。
第四步：Git 提交前确认。在 Git 工具窗口中展开变更文件列表，确认只修改了预期的变量名和对应引用，没有误触其他代码行。确认无误后，提交 commit 消息，建议采用类似“refactor: rename userList → users via Tongyi Lingma”的格式。这样未来回溯变更时，能一眼看出改动意图和工具来源。
整套流程走下来，批量重命名这件事就可以做到既快又稳。其实只要把变量解析和引用范围这两步做扎实了，后面的操作基本不会出现意外。