Xu Lei' Blog

Shanghai Library

0%

Mkdocs部署踩过的坑

发表于

mkdocs: command not found

如果你按照官方教程安装后，出现了mkdocs: command not found。恭喜你，踩到了跟我一样的大坑。然后就是各种百度、google。各种折腾，经过几个小时的折磨终于找到了解决办法：

  • pip升级最新版
  • mkdocs卸载
  • 环境变量设置
  • mkdocs再安装

pip安装最新版

  • 如果能正常升级是最好的了，不像我步步是坑。升级提示EnvironmentError: [WinError 5] 拒绝访问 解决办法
1
python -m pip install --upgrade pip -i https://pypi.douban.com/simple --user

Mkdoc卸载

1
pip uninstall mkdocs

环境变量设置

  • 这个就需要根据python安装路径，新增如下两个环境变量了
1
2
C:\Python39\Lib\site-packages
C:\Users\Administrator\AppData\Roaming\Python\Python39\Scripts

Mkdoc再安装

再安装依旧可能遇到另一个坑：OSError: [WinError 2]

1
2
python -m pip install -U pip --user
pip install mkdocs --user

恭喜你，经过九九八十一难，你的Mkdocs终于安装成功了

参考资料