划时代的 Python 包管理器 — PDM 局部&全局项目

PDM 系列目录

1、划时代的 Python 包管理器：PDM 教程 — 入门篇
2、划时代的 Python 包管理器：PDM 教程 — 原理篇
3、划时代的 Python 包管理器 — PDM 局部&全局配置
4、划时代的 Python 包管理器 — PDM 局部&全局项目
5、划时代的 Python 包管理器 — PDM 缓存机制
6、读者问：如何让 PyCharm 支持 PDM ？

---

1. pdm 的两种项目

正常情况下，我们都是使用 pdm init 来初始化项目时，而初始化后，会在本地生成一个 pyproject.toml 文件和 __pypackages__ 目录，这只是 pdm 默认的模式。

为理解方便，pdm 管理的项目，我将其分为两种

• 全局项目
• 局部项目

实际上，咱在初始化的时候，还可以再加个参数 -g/--global ，它表示该项目将使用全局的 pdm 的 pyproject.toml 配置文件。

• 若你是首次使用 -g/–global 参数，那么它将创建 ~/.pdm/global-project/ 目录，将在该目录下创建 pyproject.toml

• 若你是二次使用 -g/–global 参数，那么你输入的信息将覆盖原来的 pyproject.toml 的配置

使用过 -g 后，你再使用 pdm list -g 查看全局已安装的包时，就会发现多了个 global-project 的包？然后在 Location 列有 -e /Users/iswbm/.pdm/global-project 指定全局模式 pyproject.toml 及 pdm.lock 所在的位置

默认情况下，当你没有指定 -g 参数去执行 pdm 命令时，它只会先从本地目录读取 pyproject.toml

而当你指定 -g 命令，不管你本地项目是否为一个 pdm 创建的项目，是否存在 pyproject.toml，pdm 都只会去读取全局的 pyproject.toml

如下所示，我分别在全局和本地的 pyproject.toml 添加不同的 shell 命令，在加 -g 和 不加 -g 的效果就非常明显了

上面之所以说默认情况下如果本地目录没有 pyproject.toml ，pdm 并不会去使用全局的 pyproject.toml。

是因为 pdm 提供了一个开关（auto_global），可以自行改变这种默认的行。

2. 全局项目的包装在哪

在局部项目下，安装的包是装在了 __packages__ 下，那使用 -g 指定全局环境的包，是装在哪里呢？

尝试在 ~/.pdm 目录下寻找，并没有任何发现

实际上，它是安装在 pdm 工具本身所在虚拟环境中，而不是你机器全局的 Python 环境中。

3. 局部项目的检测？

使用 -g 参数后，你可以在机器的任何位置执行命令，而不加 -g 呢？难道要当前目录下有 pyproject.toml 才可以？

这样岂不是要求你需要处于项目的根目录才可以 pdm 管理局部项目？

经过测试，可以发现 pdm 并不需要你处于项目的根目录，只要你所处的位置的父级目录中有发现 pyproject.toml 一样可以管理局部项目（实际是不是这个逻辑，没有看源代码还不确定）

4. 如何指定项目？

上面介绍了两种 pdm 的项目：

• 全局项目：可以在任意位置使用 pdm 去管理全局项目
• 局部项目：只能在项目根目录或及子目录里使用 pdm 管理项目

而实际使用中，你可能还希望能在任意位置去管理非全局项目，这个需求只要你加 -p/--project 即可实现

那有没有办法使用 a 项目的 pyproject.toml 及 pdm.lock 去管理 b 项目呢？

答案是不行。

pyproject.toml 及 pdm.lock 所在的位置就是 pdm 管理项目的根目录，无法通过 -p 来实现该需求。

絮叨一下

我在知乎上写过很多的 Python 相关文章，其中包括 Python 实用工具，Python 高效技巧，PyCharm 使用技巧，很高兴得到了很多知乎朋友的认可和支持。在他们的鼓励之下，我将过往文章分门别类整理成三本 PDF 电子书

PyCharm 中文指南

《PyCharm 中文指南》使用 300 多张 GIF 动态图的形式，详细讲解了最贴合实际开发的 105个 PyCharm 高效使用技巧，内容通俗易懂，适合所有 Python 开发者。

在线体验地址：https://pycharm.iswbm.com

Python 黑魔法指南

《Python黑魔法指南》目前迎来了 v3.0 的版本，囊集了 100 多个开发小技巧，非常适合在闲时进行碎片阅读。

在线体验地址：https://magic.iswbm.com

Python 中文指南

学 Python 最好的学习资料永远是 Python 官方文档，可惜现在的官方文档大都是英文，虽然有中文的翻译版了，但是进度实在堪忧。为了照顾英文不好的同学，我自己写了一份 面向零基础的朋友 的在线 Python 文档 – 《Python中文指南》

在线体验地址：https://python.iswbm.com