安装Apache AGE Python驱动时antlr4-python3-runtime安装失败

针对你在安装Apache AGE Python驱动依赖时，遇到的antlr4-python3-runtime因网络无法连接files.pythonhosted.org导致安装失败的问题，提供以下几种解决办法：

方法一：本地手动安装已下载的包 #

既然你已经能直接下载该包的文件，可通过本地安装绕过网络问题：

1. 确保下载的是与你的Python3.10版本匹配的wheel包（文件名通常包含cp310标识）
2. 激活虚拟环境后，执行本地安装命令：

   pip3 install /你的下载路径/antlr4-python3-runtime-xxx.whl
   

3. 安装完成后，再执行pip3 install -r requirements.txt，此时该依赖已存在，会跳过安装

方法二：更换pip国内镜像源 #

网络访问官方源不畅是这类问题的常见原因，换成国内镜像可解决：

• 临时使用镜像：直接在安装命令后添加镜像参数

  pip3 install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
  

• 永久配置镜像：
  1. 创建pip配置文件（若不存在）：

     mkdir -p ~/.pip && nano ~/.pip/pip.conf
     

  2. 在文件中写入以下内容并保存：

     [global]
     index-url = https://pypi.tuna.tsinghua.edu.cn/simple
     

  3. 之后再执行pip3 install -r requirements.txt即可自动使用国内镜像

方法三：排查系统网络问题 #

1. 先确认系统基础网络是否正常，执行以下命令测试：

   ping github.com
   

   如果无法ping通，需先解决Ubuntu的网络连接问题（比如检查网卡配置、防火墙、路由器设置）
2. 检查是否存在代理冲突：执行echo $HTTP_PROXY $HTTPS_PROXY查看代理环境变量，若有不需要的代理，可通过unset HTTP_PROXY HTTPS_PROXY临时关闭

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