PyScripter及IDLE导入Arcpy失败，配置PYTHONPATH仍报错如何解决

1. 版本与架构匹配检查 #

ArcGIS Desktop 10.8默认仅绑定32位Python 2.7，只要当前PyScripter/IDLE调用的是Python 3.x版本、或64位Python 2.7，都会直接识别不到arcpy。
验证方法：执行代码：

import sys
print(sys.version)
print("是否为64位：", sys.maxsize > 2**32)

如果输出不是Python 2.7.x、且64位输出为True，需要调整PyScripter的解释器路径，指向ArcGIS配套的Python 2.7 32位可执行文件（默认路径为C:\Python27\ArcGIS10.8\python.exe）。

2. .pth文件生效验证 #

你配置的Desktop10.8.pth必须放在当前Python解释器对应的site-packages目录下才会被自动加载，默认正确放置路径为C:\Python27\ArcGIS10.8\Lib\site-packages。
验证路径是否已加载：执行代码：

import sys
for path in sys.path:
    print(path)

检查输出列表中是否包含你配置的三个arcpy相关路径，不存在则说明pth文件未生效，可手动在代码开头添加路径临时验证：

import sys
sys.path.extend([
    r"C:\Program Files (x86)\ArcGIS\Desktop10.8\bin",
    r"C:\Program Files (x86)\ArcGIS\Desktop10.8\ArcPy",
    r"C:\Program Files (x86)\ArcGIS\Desktop10.8\ArcToolBox\Scripts"
])
import arcpy

3. 权限与安装完整性检查 #

• 尝试以管理员身份启动PyScripter/IDLE后再导入arcpy，排除Program Files目录读取权限不足的问题
• 检查C:\Program Files (x86)\ArcGIS\Desktop10.8\ArcPy目录下是否存在__init__.py文件，缺失则说明ArcGIS安装损坏，需要运行安装程序执行修复操作

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