rope适合安全跨文件重命名，依赖完整项目结构和正确配置；jedi仅定位引用位置，不修改代码且缺乏语义准确性。
rope 和 jedi 都能做重命名，但触发方式和作用范围完全不同
rope 是纯 Python 实现的重构引擎，它操作的是 AST + 项目符号表，必须基于完整项目结构（.ropeproject 目录），重命名会跨文件修改所有引用；jedi 是静态分析补全库，它的 rename 功能只是“找出所有可能匹配位置”，不改代码，也不保证语义正确性——比如对同名局部变量、字符串里的假匹配也会标出来。
实操建议：
- 需要安全、可回退、跨文件重命名（如把
user_id改成uid并同步更新所有调用处）→ 用rope - 只在编辑器里快速预览“这个变量在哪被用了” →
jedi.Script(...).get_references()足够，但别当真去批量替换 -
jedi对动态属性（getattr(obj, name)）、exec、装饰器包裹的函数基本无能为力；rope同样不处理运行时行为，但它至少会跳过明显不可达路径
rope 的 rename 命令依赖准确的项目根和 Python 版本配置
rope 不读 pyproject.toml 或 setup.py，它靠 .ropeproject/config.py 里的 python_version 和 source_folders 判断作用域。配错版本（比如设成 "3.8" 但代码用了 match 语句），AST 解析直接失败，rope.rename 会报 SyntaxError: invalid syntax，而不是跳过。
常见错误现象：
立即学习“Python免费学习笔记（深入）”；
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 重命名后部分文件没更新 → 检查
source_folders是否漏了子包路径 -
rope找不到模块 → 确认ropeproject在项目根，且sys.path没被 IDE 临时污染（VS Code 的 Python 扩展有时会干扰） - 重命名插入了奇怪的空格或换行 → 关闭
rope的remove_imports选项，或手动清理导入行
jedi 的 Script.rename 返回的是位置列表，不是重构动作
很多人以为 jedi.Script(...).rename(...) 会像 IDE 一样改代码，其实它只返回 [Definition(...), Definition(...)] —— 每个 Definition 有 .line、.column、.module_path，你要自己读文件、替换文本、写回去。而且它默认不区分作用域：类内同名参数、嵌套函数里的局部变量、甚至注释里的单词都可能被包含。
使用场景限制：
- 适合写脚本批量提取“某标识符所有出现位置”，比如统计
print调用点 - 不适合替代
rope做生产环境重构，因为没作用域过滤、没重命名冲突检测、不处理别名（import numpy as np中的np.array不会被识别为numpy.array） - 性能上，
jedi每次调用都重新解析，大项目里反复查同一个变量很慢；rope一次构建项目索引，后续操作快得多
实际项目中别混用，优先选 rope 但得接受它不支持动态代码
如果你的代码大量用 __getattr__、globals()[name]、eval 或框架魔改（比如 Django 的 models.CharField 字段名反射），rope 会漏掉引用，jedi 更是完全失效。这时候所谓“重构工具”只是给你一个带噪声的参考列表。
容易被忽略的点：
-
rope默认不重命名字符串字面量里的内容，但你可以开unsure模式，代价是误伤率飙升 -
jedi的rename方法在 0.19+ 版本才加，旧版只有get_references，名字一样但返回值类型不同 - 两者都不理解类型提示中的字符串前向引用（
"User"），rope 会跳过，jedi 可能误判为普通字符串
真要动核心变量名，先跑一遍 rope，再 grep 全局确认，最后人工扫一眼动态调用点——工具只是省力，不是免责。
