Windows下Python路径异常致PIP警告及MKDocs安装失败咨询

1. 升级PIP时的警告是否正常？ #

是正常现象。这是Python用户级安装模式的默认行为：当你未用管理员权限执行pip install --upgrade pip时，pip会自动将自身安装到当前用户的AppData/Roaming目录（而非系统级的Program Files目录），该目录默认不在系统PATH中，因此触发路径警告。

2. 为什么Python相关文件出现在Roaming目录而非之前的Local目录？ #

• Roaming是Windows用于跨设备同步用户配置与数据的文件夹，当pip以用户模式安装包/工具时，会优先选择此目录，方便域环境下同步个人Python依赖。
• 此前的Local目录是本地用户专属、不参与同步的存储区，通常是Python安装程序默认的用户级包存储位置，但pip的行为会因版本、安装场景略有差异，本次升级pip触发了用户模式安装，因此路径切换到Roaming。

3. MKDocs安装问题的解决办法 #

MKDocs被安装到AppData/Roaming的site-packages是用户模式安装的正常结果，所谓“无法安装”本质是该目录的脚本未在PATH中，导致安装后找不到mkdocs命令。可通过两种方式解决：

• 手动添加路径到PATH：
  1. 右键“此电脑”→属性→高级系统设置→环境变量
  2. 在用户变量的Path中添加C:\Users\User\AppData\Roaming\Python\Python311\Scripts，保存设置
• 强制系统级安装：
  用管理员权限打开命令提示符，执行以下命令：

  pip install mkdocs --no-user
  

  这样MKDocs会被安装到C:\Program Files\Python311\site-packages，对应的脚本也会位于系统PATH已包含的Scripts目录下。

内容的提问来源于stack exchange，提问作者Angelica Deviana