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 版本再选依赖,避免先写文档后返工。