无法安装Python模块‘arcgis’：Python路径配置异常求助

尝试从PyPI安装arcgis模块时失败，命令行执行报错如下：

(base) PS C:\Python311\Scripts> .\pip3.11.exe install arcgis
Could not find platform independent libraries <prefix>
Python path configuration:
  PYTHONHOME = (not set)
  PYTHONPATH = (not set)
  program name = 'C:\Python311\python.exe'
  isolated = 0
  environment = 1
  user site = 1
  safe_path = 0
  import site = 1
  is in build tree = 0
  stdlib dir = 'C:\Python311\Scripts\Lib'
  sys._base_executable = 'C:\\Python311\\python.exe'
  sys.base_prefix = 'C:\\Python311\\Scripts'
  sys.base_exec_prefix = 'C:\\Python311'
  sys.platlibdir = 'DLLs'
  sys.executable = 'C:\\Python311\\python.exe'
  sys.prefix = 'C:\\Python311\\Scripts'
  sys.exec_prefix = 'C:\\Python311'
  sys.path = [
    'C:\\Python311\\python311.zip',
    'C:\\Python311\\Scripts\\Lib',
    'C:\\Python311\\DLLs',
  ]
Fatal Python error: init_fs_encoding: failed to get the Python codec of the filesystem encoding
Python runtime state: core initialized
ModuleNotFoundError: No module named 'encodings'

Python版本为3.11，符合arcgis模块≥3.9且<3.12的版本要求，未设置PYTHONHOME/PYTHONPATH，未使用虚拟环境。

从路径配置信息可以看出，Python错误地将标准库目录（stdlib dir）指向了C:\Python311\Scripts\Lib，而正常情况下标准库应该在C:\Python311\Lib。这种路径混乱导致Python找不到核心的encodings模块，进而触发初始化失败。

方法1：使用Python自带的pip（优先推荐） #

避免直接从Scripts目录调用pip，而是通过Python解释器直接调用pip，确保路径关联正确：

python -m pip install arcgis

方法2：手动配置PYTHONHOME环境变量 #

1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
2. 在「系统变量」区域点击「新建」：
   • 变量名：PYTHONHOME
   • 变量值：C:\Python311
3. 重启命令行窗口，重新运行安装命令

方法3：修复Python安装 #

若上述方法无效，可能是Python安装文件损坏：

1. 打开Python 3.11的安装程序（若已丢失，重新下载对应版本的官方安装包）
2. 选择「Modify（修改）」选项
3. 确保勾选「Add Python to PATH」，点击「Repair（修复）」完成安装修复

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