为何需要使用pip install -e？本地克隆包修改后直接导入不行吗？

你觉得直接克隆源码修改后导入就能生效，其实只在特定场景下成立——比如你的脚本和源码放在同一个目录，或者手动把源码路径加到了Python的模块搜索路径里。但大多数时候，pip install -e解决了直接克隆源码的几个核心问题：

• 自动处理模块搜索路径：Python只会从sys.path里的目录查找可导入的模块。直接克隆的源码文件夹默认不在这个路径里，除非你每次运行脚本都手动用sys.path.append("/path/to/your/package")，或者把源码放到Python默认搜索的位置（比如site-packages）。而pip install -e会在site-packages目录创建一个.egg-link文件，把你的本地源码路径自动加入到sys.path中，这样不管你在哪个目录运行脚本，都能直接import包，不用手动处理路径。

• 自动安装依赖：绝大多数Python包都有依赖项（比如requests、numpy这类）。直接克隆源码的话，你得自己去读包的requirements.txt或pyproject.toml，手动安装所有依赖。pip install -e会自动读取包的配置文件，把所有依赖一次性安装好，省去手动操作的麻烦。

• 支持控制台脚本/入口点：如果包定义了控制台脚本（比如很多CLI工具在setup.py里通过entry_points配置的命令），直接克隆源码后，这些脚本不会被添加到系统的可执行路径里，你得跑到源码目录里手动运行脚本文件。pip install -e会把这些脚本链接到你的Python环境的bin（Linux/macOS）或Scripts（Windows）目录，直接在终端就能调用，和正常安装的包用法完全一致。

• 纳入环境管理体系：用pip list可以看到这个包的信息，明确标记它是editable模式安装的，方便你管理环境里的所有包。如果是直接克隆的源码，pip完全不知道它的存在，时间久了你可能都忘了本地有这个包，也没法用pip的命令来管理它。

• 适配包的结构规范：很多现代Python包会把源码放在src/目录下（比如src/my_package/），直接克隆后你得写import src.my_package才能导入，不符合常规的包导入习惯。pip install -e会按照包的配置文件（比如setup.py）里的设置，把正确的源码路径暴露出来，你可以直接import my_package，和使用正常安装的包没有区别。

举个实际例子：你把一个包克隆到~/dev/my-awesome-package，源码在~/dev/my-awesome-package/src/my_awesome_package/。直接克隆后，在~/other-project目录运行脚本import这个包会报错；但用pip install -e ~/dev/my-awesome-package之后，不管你在哪个目录，都能直接import my_awesome_package，而且修改src里的代码，下次导入会立即生效。

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