如何在PyCharm中批量重命名变量并统一添加self.前缀

报错原因 #

Shift+F6是PyCharm的标识符重命名功能，仅支持输入合法的单个标识符，而self.包含.符号，不属于合法标识符范畴，因此触发报错。

可行操作方案 #

下面是3种适配不同场景的操作方式：

方法1：结构化搜索替换（适合跨文件/大范围批量修改） #

• 按下Ctrl+Shift+R（Mac系统对应Cmd+Shift+R）调出全局替换窗口，点击窗口右上角的结构搜索替换图标
• 搜索模板填写$var$，下方筛选条件设置为「Python 表达式」，可额外增加上下文筛选规则，仅匹配类内部未绑定实例的目标变量
• 替换模板填写self.$var$
• 先点击「查找」预览所有匹配结果，确认无错误匹配后，执行批量替换即可

方法2：多选编辑（适合单文件小范围修改） #

• 选中第一个需要修改的变量名，按下Alt+J（Mac系统对应Ctrl+G）逐个选中所有需要修改的同名单词；也可以按住Alt键拖动鼠标拉出竖选光标，批量选中所有变量前的插入位置
• 直接输入self.即可同步给所有选中位置添加前缀

方法3：快速修复（适合单变量全引用修改） #

• 把光标定位到需要修改的变量上，按下Alt+Enter调出快速修复菜单
• 选择「将变量转为属性」选项，PyCharm会自动给所有引用该变量的位置添加self.前缀，同时会自动在__init__方法中添加该属性的初始化逻辑

注意事项 #

批量修改前建议先提交当前代码到版本控制系统，避免误修改后无法回滚。

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