Windows10下Python2.7与3.9的Roaming目录结构适配及Scripts环境变量修正咨询

对齐Python 3.9的Roaming路径收纳逻辑 #

差异根源 #

Python 2.7.18（官方最后一个正式版本）的安装器没有实现Python 3.x引入的嵌套目录设计：老版本默认将用户级配置、用户安装包、用户Scripts文件夹直接散落在%USERPROFILE%\AppData\Roaming\根目录下，因此会出现独立的Python27和Scripts两个文件夹；Python 3.9及之后的版本会把所有用户级内容统一收纳在版本号命名的单一文件夹下，避免多版本共存时的根目录冲突。

具体调整步骤 #

• 前置准备：关闭所有运行中的Python 2.7进程、关联终端、pip会话，避免文件被占用导致操作失败
• 目录迁移：将Roaming路径下独立存在的Scripts文件夹整体剪切移动到同路径下的Python27文件夹内部，最终形成的嵌套结构为%USERPROFILE%\AppData\Roaming\Python27\Scripts，和Python 3.9的单目录收纳逻辑完全统一，不再有散落在Roaming根目录的独立Scripts条目
• 固化路径配置：在Python 2.7的全局站点目录C:\Program Files\Python27\Lib\site-packages下新建sitecustomize.py文件，写入以下自定义逻辑，让Python启动时自动识别嵌套结构，不再在根目录散建文件夹

import os
import site

# 定义统一收纳的用户目录根路径，对齐Python3.x的路径规则
user_base = os.path.expandvars(r"%USERPROFILE%\AppData\Roaming\Python27")
# 覆盖Python2.7默认散落的根目录路径配置
site.USER_BASE = user_base
site.USER_SITE = os.path.join(user_base, "site-packages")
site.USER_SCRIPTS = os.path.join(user_base, "Scripts")

• 生效验证：重启Python 2.7解释器会话，执行pip2 install --user 任意测试包，检查生成的可执行脚本是否自动出现在嵌套的Python27\Scripts目录下，不再在Roaming根目录生成独立文件夹。

Scripts路径环境变量修正 #

必须对当前错误的环境变量配置进行修正，首先澄清路径错位的核心原因：

• 安装向导默认配置的C:\Program Files\Python27\Scripts是Python 2.7的全局系统级脚本目录，设计用途是存放pip、easy_install等全局安装的可执行工具
• 你实际看到的C:\Program Files\Python27\Tools\Scripts并非真正的脚本安装目录，这个路径是Python源码包内置的开发工具示例文件夹，本来就不是给pip安装脚本用的。出现这个路径错位的核心原因是：Program Files目录默认给普通用户的权限只有读取，没有写入，pip在安装全局脚本时因为没有写入权限，才会自动把脚本存到有权限的Tools子目录下。

具体修正步骤 #

• 打开系统环境变量配置面板，依次检查用户级、系统级的Path环境变量条目
• 删除所有错误指向C:\Program Files\Python27\Tools\Scripts的条目
• 可选两种正确配置方式：
  • 方式一：保留全局目录的设置，补全C:\Program Files\Python27\Scripts的当前用户写入、修改权限，再将这个路径加入Path变量
  • 方式二：不修改Program Files目录权限，直接将Path变量里的Python 2.7 Scripts条目替换为之前调整好的用户级嵌套路径%USERPROFILE%\AppData\Roaming\Python27\Scripts，和之前的目录结构适配逻辑完全统一
• 生效验证：重启终端，执行py -2 -m pip --version，如果可以正常输出版本信息，且后续安装全局包时生成的脚本会自动存入对应配置的Scripts目录，即说明配置正常。

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