跳转至

010 · Python 3.6 无法安装 mkdocs-material

问题现象

pip install mkdocs-material 报错,依赖要求 pymdown-extensions>=9.4 等与 Python 3.6 不兼容。

排查过程

  • 执行 python3 --version 对照 Material 官方要求。
  • 评估「锁旧版 Material」与「升级 Python」的维护成本。

根因

系统自带 Python 过旧,不满足当前 Material 依赖下界。

改进计划

将宿主机 Python 升至 3.8+(官方包/pyenv/SCL 等),再 pip install;pip 可用国内镜像加速。

经验教训

在云主机装文档栈前 先固定 Python 版本再选依赖,避免先写文档后返工。