PyODPS 安装常见问题解决

摘要： 本文将用户安装 PyODPS 时遇到的常见问题列举以下，但愿在遇到相似问题时可供借鉴。在参考下列步骤以前，请首先尝试卸载并重装 PyODPS。卸载的步骤为执行“pip uninstall pyodps”。

点此查看原文：http://click.aliyun.com/m/41050/

本文将用户安装 PyODPS 时遇到的常见问题列举以下，但愿在遇到相似问题时可供借鉴。在参考下列步骤以前，请首先尝试卸载并重装 PyODPS。卸载的步骤为执行“pip uninstall pyodps”。

1. Warning: XXX not installed, ......

Warning 不是 Error，Warning 不是 Error，Warning 不是 Error，重要的事情说三遍！

参考 Warning 文字，它将告诉你须要什么组件，你可使用 pip 命令进行安装。

2. 安装后 import odps 报 no module named odps
这说明 odps package 没法被加载。这里有几种可能对的情形

安装有多个 Python 版本。这常见于 Mac 下使用 Homebrew 安装新的 Python 包（而不是系统自带的 Python），或者同时安装了 Python 2 和 Python 3，或者同时安装了 CPython 和 Anaconda / Miniconda，而当前使用的 Python 下并未安装 PyODPS。为确认此问题，请遵循下列步骤：

打开 Python 命令行；
执行 import site; print(site.getsitepackages())；
检查输出的每一个路径中是否存在名为“odps”的文件夹。若不存在，确认此问题。
若是问题确认，请使用命令行定位到须要安装的 Python 路径，而后执行 ./python -m pip install pyodps[full]。

在 Mac / Linux 下可以使用

find / -regex '.*/python[^\./-]*' 2>/dev/null

查找本机到底安装了几个 Python。

Search Path（一般是当前目录）中包含一个 odps.py 或一个包含 __init__.py 的名为 odps 的文件夹。该文件多是你本身不当心建立的，或者曾经安装过一个名为“odps”的 Python 包。对于前者，请检查后将该文件改名。对于后者，请尝试使用“pip uninstall odps”进行删除。

3. 安装后 "from odps import *" 报 cannot import name ODPS

首先须要检查当前工做路径下是否存在一个文件名为“odps.py”的文件。若是存在，请更名后再 import，不然可参照 2 中的步骤进行排查。

4. 安装后 import odps 报 cannot import module odps / odps.xxxx
这一般是因为 PyODPS 遇到了依赖问题。请联系 PyODPS 技术支持钉钉群（11701793），咱们将尝试修复该问题。

尝试pip install -U jupyter能够解决此场景下的大多数问题。

5. 安装时报 Syntax Error

Python 版本太低。PyODPS 主流支持 Python 2.7.6+ / Python 3.3+，并同时支持 Python 2.6。Python 2.5 及如下版本不被支持。建议使用主流支持的版本。

6. Mac 上安装时报 Permission denied

尝试使用

sudo pip install pyodps

7. Mac 上 sudo 安装仍然报 Operation not permitted

这是因为系统完整性保护致使的。参考 http://stackoverflow.com/ques... ，重启机器，并在重启中按 ⌘+R。此后在终端中运行

csrutil disable
reboot

此后再行安装。

8. 使用时报 sourceIP is not in the white list

存在白名单保护，可咨询 Project Owner。

9. Jupyter 前端 UI 有问题

能够尝试卸载并从新安装 jupyter、ipywidgets 以及 widgetsnbextension，也能够尝试在 bash 执行

jupyter nbextension enable pyodps/main

若有问题，PyODPS 技术支持钉钉群，群号 11701793