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