如何重命名Python包并自动更新所有导入语句？（mistree_pp改mistree）

方法1：修改已安装包的目录并添加兼容层 #

这是最快的临时修改方式，无需重新编译或克隆源码：

• 第一步，找到包的安装路径：
  执行以下命令获取mistree_pp的安装位置：

  pip show mistree_pp
  

  复制输出中的Location路径（Windows下通常在用户目录的AppData/Local/Python/site-packages下）。
• 第二步，重命名包目录：
  进入上述路径，将mistree_pp文件夹直接改名为mistree。
• 第三步，添加兼容文件：
  在同一目录下创建mistree_pp.py文件，写入以下内容：

  from mistree import *
  __all__ = [name for name in dir() if not name.startswith('_')]
  

  这样既保证旧的import mistree_pp语句不会报错，新项目代码可以直接用import mistree。

方法2：项目级导入映射（跨平台推荐） #

无需修改已安装的包，通过配置让Python自动将mistree指向mistree_pp：

• 持久化配置（推荐项目使用）：
  在项目根目录创建或编辑pyproject.toml，添加：

  [tool.python-mapping]
  mistree = "mistree_pp"
  

  确保你的Python环境支持python-mapping工具（如果没有，可先安装pip install python-mapping）。
• 临时快速配置：
  在项目的入口文件最顶部添加以下代码：

  import sys
  import mistree_pp
  
  sys.modules['mistree'] = mistree_pp
  

  这样所有后续的import mistree都会直接引用mistree_pp模块，无需修改项目里的导入语句。

方法3：从源码修改后重新安装（彻底解决） #

如果需要永久将包名改为mistree，可以从源码修改后安装：

• 克隆指定分支的源码：

  git clone --branch pure_python https://github.com/knaidoo29/mistree.git
  

• 修改包名相关内容：
  1. 进入克隆的mistree目录，将mistree_pp文件夹重命名为mistree。
  2. 编辑setup.py，将name参数改为mistree，并把packages列表里的mistree_pp替换为mistree。
• 本地安装修改后的包：

  pip install .
  

  安装完成后，你的环境里就只有mistree包，所有导入都可以直接用import mistree。

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