‘pip install -e .‘ and ‘pip install .‘
Content
- 1️⃣ `pip install -e .`
- 工作原理
- 常见使用场景
- 2️⃣ `pip install .`
- 3️⃣ 两者核心区别
- 4️⃣ 举个最直观例子
- 使用
- 使用
- 5️⃣ 实际开发中怎么用
- 6️⃣ 一个很多人不知道的小知识
这两个命令都是用来安装当前目录中的 Python 项目（通常包含setup.py或pyproject.toml），但行为不同。
1️⃣pip install -e .
含义：
-e表示editable（可编辑模式）.表示当前目录
完整含义：
以可编辑模式安装当前 Python 项目
工作原理
pip不会复制代码到 site-packages，而是创建一个链接（link）指向当前目录。
因此：
- 你修改源码
- 不需要重新安装
- Python 会立即使用最新代码
常见使用场景
开发阶段：
例如开发一个库：
my_project/ │ ├── mylib/ │ ├── __init__.py │ └── model.py │ └── setup.py执行
pip install -e .然后：
importmylib如果你修改：
mylib/model.py无需重新安装，修改立刻生效。
所以：
pip install -e .=开发者模式安装
2️⃣pip install .
含义：
正常安装当前项目
执行后：
pip 会
- 打包项目
- 复制到
site-packages/例如：
/usr/lib/python3.x/site-packages/此时：
- 代码与当前目录脱离
- 修改源码不会影响已安装版本
如果修改源码，需要重新安装：
pip install .3️⃣ 两者核心区别
| 命令 | 安装方式 | 修改代码是否生效 | 用途 |
|---|---|---|---|
pip install -e . | 链接到源码 | ✅ 立即生效 | 开发 |
pip install . | 复制到site-packages | ❌ 不生效 | 发布/使用 |
4️⃣ 举个最直观例子
假设你开发一个包：
hello_pkg/ ├── hello/ │ └── say.py └── setup.py使用
pip install -e .然后：
fromhello.sayimporthi如果你改：
say.py程序立刻使用新代码。
使用
pip install .然后改：
say.py程序不会改变，因为运行的是：
site-packages/hello/5️⃣ 实际开发中怎么用
开发库时100%用这个
pip install -e .例如常见项目：
- ROS python packages
- PyTorch projects
- OpenAI projects
- Huggingface projects
6️⃣ 一个很多人不知道的小知识
pip install -e .本质上做的是：
创建一个
site-packages/xxx.egg-link文件，里面写着：
/path/to/your/projectPython 导入模块时就会跳转到源码目录。
✅一句话总结
pip install -e . → 开发模式安装（源码链接） pip install . → 正式安装（复制代码）