在GoLand/WebStorm中批量重命名符号的自动化方案咨询

一、IDE内置结构替换功能（推荐） #

这是JetBrains系列IDE原生支持的精准批量修改工具，能识别代码上下文，比sed更可靠，还能配合版本控制生成补丁：

• 打开Edit > Find > Replace Structurally（快捷键：Windows/Linux为Ctrl+Shift+R，Mac为Cmd+Shift+R）
• 在「查找模板」输入pkg1.Map，「替换模板」输入pkg2.Map
• 点击「编辑变量」，确保Map被识别为符号而非普通字符串，选择「整个项目」或指定模块作为搜索范围
• 预览所有匹配项确认无误后点击「替换」，之后在终端执行git diff > symbol-rename.patch即可生成补丁文件

二、IDE控制台Groovy脚本实现（自定义场景） #

如果结构替换无法满足复杂需求，可直接调用IDE的代码分析API实现自动化，以下是可直接运行的Groovy示例（以GoLand为例）：

import com.intellij.openapi.project.ProjectManager
import com.intellij.psi.PsiManager
import com.intellij.psi.search.GlobalSearchScope
import com.intellij.psi.search.FilenameIndex
import com.intellij.psi.go.PsiGoFile
import com.intellij.psi.PsiReferenceExpression
import com.intellij.refactoring.rename.RenameProcessor

// 获取当前打开的项目
def project = ProjectManager.getInstance().openProjects[0]
def searchScope = GlobalSearchScope.allScope(project)

// 遍历项目中所有Go文件
def psiManager = PsiManager.getInstance(project)
def goFiles = FilenameIndex.getAllFilesByExt(project, "go", searchScope)

goFiles.each { file ->
    def psiFile = psiManager.findFile(file)
    if (psiFile instanceof PsiGoFile) {
        // 递归遍历文件内所有元素
        psiFile.acceptChildren({ element ->
            if (element instanceof PsiReferenceExpression) {
                def qualifierText = element.qualifierExpression?.text
                def refName = element.referenceName
                // 匹配pkg1.Map的引用
                if (qualifierText == "pkg1" && refName == "Map") {
                    // 执行重命名操作
                    new RenameProcessor(project, element, "pkg2.Map", false, false).run()
                }
            }
            return true
        })
    }
}

• 使用步骤：
  1. 打开IDE的Tools > IDE Scripting Console，选择Groovy环境
  2. 根据你的开发语言替换对应Psi类（比如WebStorm需替换为PsiJavaScriptFile）
  3. 运行脚本，IDE会自动修改所有匹配的符号引用
  4. 执行git diff > rename-patch.patch生成补丁

三、补充方案 #

• Go项目可结合go mod edit -replace pkg1=pkg2调整依赖路径，再用go fmt自动修正包引用，但仅适用于包路径变更场景
• 若需跨多个独立项目操作，可将结构替换的配置导出为XML文件，在每个项目中导入执行

内容的提问来源于stack exchange，提问作者John White