为何pip会访问两个site-packages路径？

问题原因 #

• 权限不足触发自动user安装：OSGeo4W的Python站点包目录（c:\osgeo4w\apps\python39\lib\site-packages）位于系统盘根目录，普通用户默认无写入权限。当pip尝试安装依赖时，若检测到系统级目录无法写入，会自动切换到user安装模式，将包安装到用户专属目录（c:\users\hbh1\appdata\roaming\python\python39\site-packages）。
• pip配置残留默认user模式：若之前执行过pip install --user命令，pip的配置文件可能被设置了默认--user参数，导致后续安装优先使用用户目录。
• 依赖版本冲突+权限限制：如果OSGeo4W环境中已存在某个依赖的旧版本，但pb_tool需要更高版本，而升级系统级目录下的旧版本需要管理员权限，pip会选择安装到用户目录绕过权限问题。

解决办法 #

1. 以管理员身份运行命令行 #

打开你提供的bat脚本时，右键选择以管理员身份运行，此时OSGeo4W的站点包目录会获得写入权限，pip会将所有包直接安装到OSGeo4W路径下，不会触发user模式。

2. 强制禁用user安装模式 #

执行安装命令时添加--no-user参数，强制pip尝试安装到系统级目录，若权限不足会直接报错而非自动切换路径：

python -m pip install pb_tool --no-user

3. 检查并重置pip配置 #

• 查看当前pip配置，确认是否默认开启user模式：

  python -m pip config list
  

• 若输出包含global.user=true，执行以下命令取消默认配置：

  python -m pip config unset global.user
  

4. 迁移已安装的用户目录包 #

• 先卸载用户目录下的冲突依赖：

  python -m pip uninstall colorama Sphinx
  

• 再用管理员权限或--no-user参数重新安装pb_tool，确保所有依赖都进入OSGeo4W路径。

5. 优化bat脚本（避免环境混淆） #

在脚本中直接指定OSGeo4W的Python路径，彻底避免调用到其他Python环境：

@echo off
SET OSGEO4W_ROOT=C:\OSGeo4W
set path=%OSGEO4W_ROOT%\bin;%WINDIR%\system32;%WINDIR%;%WINDIR%\system32\WBem
path %PATH%;%OSGEO4W_ROOT%\apps\Python39\Scripts
path %PATH%;%OSGEO4W_ROOT%\apps\qgis-ltr\bin
path %PATH%;%OSGEO4W_ROOT%\apps\grass\grass78\lib
path %PATH%;%OSGEO4W_ROOT%\apps\Qt5\bin

set PYTHONPATH=%PYTHONPATH%;%OSGEO4W_ROOT%\apps\qgis-ltr\python
set PYTHONHOME=%OSGEO4W_ROOT%\apps\Python39

set PATH=C:\Program Files\Git\bin;%PATH%

:: 直接指定OSGeo4W的Python路径，避免环境混淆
"%OSGEO4W_ROOT%\apps\Python39\python.exe" -m pip install pb_tool --no-user
:: 或者打开cmd后手动执行上述命令
cmd.exe

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