本文详解在未发布到 PyPI 的前提下，如何高效、规范地手动安装本地 Python 库，重点对比 pip install . 与 pip install -e . 的适用场景，并说明现代 pyproject.toml 构建流程下的最佳实践。
本文详解在未发布到 pypi 的前提下，如何高效、规范地手动安装本地 python 库，重点对比 `pip install .` 与 `pip install -e .` 的适用场景，并说明现代 `pyproject.toml` 构建流程下的最佳实践。
对于正在开发中、尚未上传至 PyPI 的 Python 库，用户最常用且官方推荐的手动安装方式是直接在项目根目录（即包含 pyproject.toml 或 setup.py 的目录）执行：
pip install .
该命令会自动读取 pyproject.toml 中的构建后端配置（如 build-backend = "setuptools.build_meta"），调用 build 工具生成临时 wheel，再完成安装——整个过程无需手动构建、无需关注 dist/ 目录，简洁可靠，适用于绝大多数测试与协作场景。
若开发者自身需要频繁修改源码并立即验证效果（例如调试 API 或迭代功能），则应使用可编辑安装（editable install）：
pip install -e .
该模式不会复制代码文件到 site-packages，而是创建指向源码目录的符号链接（或 .pth 文件），确保 import mylib 始终加载当前工作目录下的最新代码。这是本地开发的标准做法，尤其配合虚拟环境（venv）使用时，既能隔离依赖，又避免重复安装。
立即学习“Python免费学习笔记（深入）”；
✅ 注意事项：
- 确保已安装最新版
pip（≥21.3）、build（pip install build）和wheel；旧版 pip 可能不完全兼容 PEP 517 构建协议。pyproject.toml必须正确定义build-backend和requires（如["setuptools>=61.0", "wheel"]），否则pip install .可能失败。- 不建议在生产环境或跨机器分发时优先使用
pip install -e .，因其强依赖源码路径；此时应构建并分发 wheel：python -m build # 生成 dist/mylib-0.1.0-py3-none-any.whl pip install ./dist/mylib-0.1.0-py3-none-any.whl
总结而言：pip install . 是用户手动安装的默认首选；pip install -e . 是开发者迭代的黄金标准；而显式构建 + 安装 wheel 适用于受控内部分发场景。三者均兼容现代 pyproject.toml 构建体系，无需回退到 legacy setup.py 流程。
