PyODPS 安裝常見問題解決

本文将使用者安裝 PyODPS 時遇到的常見問題列舉如下，希望在遇到類似問題時可供借鑒。在參考下列步驟之前，請首先嘗試解除安裝并重裝 PyODPS。解除安裝的步驟為執行“pip uninstall pyodps”。

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

參考 Warning 文字，它将告訴你需要什麼元件，你可以使用 pip 指令進行安裝。

這說明 odps package 無法被加載。這裡有幾種可能對的情形

安裝有多個 Python 版本。這常見于 Mac 下使用 Homebrew 安裝新的 Python 包（而不是系統自帶的 Python），或者同時安裝了 Python 2 和 Python 3，或者同時安裝了 CPython 和 Anaconda / Miniconda，而目前使用的 Python 下并未安裝 PyODPS。為确認此問題，請遵循下列步驟：

打開 Python 指令行；

執行 <code>import site; print(site.getsitepackages())</code>；

檢查輸出的每個路徑中是否存在名為“odps”的檔案夾。若不存在，确認此問題。

如果問題确認，請使用指令行定位到需要安裝的 Python 路徑，然後執行 <code>./python -m pip install pyodps[full]</code>。

在 Mac / Linux 下可使用

查找本機到底安裝了幾個 Python。

Search Path（通常是目前目錄）中包含一個 odps.py 或一個包含 __init__.py 的名為 odps 的檔案夾。該檔案可能是你自己不小心建立的，或者曾經安裝過一個名為“odps”的 Python 包。對于前者，請檢查後将該檔案更名。對于後者，請嘗試使用“pip uninstall odps”進行删除。

首先需要檢查目前工作路徑下是否存在一個檔案名為“odps.py”的檔案。如果存在，請改名後再 import，否則可參照 2 中的步驟進行排查。

這通常是由于 PyODPS 遇到了依賴問題。請聯系 PyODPS 技術支援釘釘群（11701793），我們将嘗試修複該問題。

嘗試<code>pip install -U jupyter</code>可以解決此場景下的大多數問題。

Python 版本過低。PyODPS 主流支援 Python 2.7.6+ / Python 3.3+，并同時支援 Python 2.6。Python 2.5 及以下版本不被支援。建議使用主流支援的版本。

嘗試使用

此後再行安裝。

存在白名單保護，可咨詢 Project Owner。

可以嘗試解除安裝并重新安裝 jupyter、ipywidgets 以及 widgetsnbextension，也可以嘗試在 bash 執行

如有問題，PyODPS 技術支援釘釘群，群号 11701793