全部產品
Search
文件中心

Object Storage Service:Python安裝

更新時間:Jun 19, 2024

如果您需要管理OSS儲存空間、上傳下載檔案、管理資料、進行圖片處理等,可以先安裝OSS Python SDK。本文介紹如何安裝OSS Python SDK。

環境準備

  1. 安裝Python

    OSS Python SDK適用於Python 2.6、2.7、3.3、3.4、3.5、3.6、3.7、3.8及以上版本。

    說明

    Windows環境中安裝Python SDK時,需確保Visual C++版本為15.0或以上。

  2. 安裝完成後,執行以下命令查看Python版本。

    python --version

    成功返回樣本如下。以下樣本表明您已成功安裝Python 3.8.2。

    Python 3.8.2

下載SDK

安裝python-devel

完成環境準備後,您需要先要安裝python-devel包。

說明

OSS Python SDK需要crcmod計算CRC校正碼,而crcmod依賴python-devel包中的Python.h檔案。如果系統缺少Python.h檔案,雖然之後安裝OSS Python SDK不會失敗,但crcmod的C擴充模式安裝會失敗。如果crcmod的C擴充模式安裝失敗,在上傳、下載計算CRC校正碼時會使用純Python模式進行CRC資料校正。純Python模式的效能遠差於C擴充模式,從而導致上傳、下載等操作效率非常低下。

Windows

在Windows系統安裝Python時,會將Python依賴的標頭檔一併安裝,因此無需安裝python-devel。

macOS

在macOS系統安裝Python時,會將Python依賴的標頭檔一併安裝,因此無需安裝python-devel。

CentOS

執行以下命令安裝python-devel。

sudo yum install python-devel                 

RHEL

執行以下命令安裝python-devel。

sudo yum install python-devel                 

Fedora

執行以下命令安裝python-devel。

sudo yum install python-devel                 

Debian

執行以下命令安裝python-devel。

sudo apt-get install python-dev                  

Ubuntu

執行以下命令安裝python-devel。

sudo apt-get install python-dev                  

安裝SDK

安裝python-devel後,您可以選擇以下方式安裝OSS Python SDK。

pip

  1. 安裝pip

    Python 2.7.9+或者Python 3.4+以上版本預設已安裝pip。

  2. 執行以下命令安裝最新版本的OSS Python SDK。

    pip install oss2                   

源碼

  1. GitHub下載最新版本的OSS Python SDK,解壓後進入目錄,確認目錄下有setup.py檔案。

    如需下載歷史版本的OSS Python SDK,請參見歷史版本

  2. 執行以下命令安裝OSS Python SDK。

    python setup.py install                   

驗證SDK

安裝SDK後,執行以下步驟驗證已安裝的OSS Python SDK。

  1. 執行以下命進入Python環境。

    python
  2. 執行以下命令查看OSS Python SDK版本。

    import oss2
    oss2.__version__                         

    成功返回樣本如下。以下樣本表明您已經成功安裝OSS Python SDK 2.18.3。

    '2.18.3'

常見問題

報錯No module named _crcfunext

問題現象

使用OSS Python SDK調用上傳、下載介面較其他工具如ossutil或者其他SDK慢了很多

問題原因

編譯crcmod時,由於_crcfunext.so依賴Python.h檔案,而系統中缺少這個標頭檔,因此_crcfunext.so庫產生失敗。關於crcmod的更多資訊,請參見crcmod introduction

解決方案

驗證crcmod的C擴充模式是否安裝成功。

  1. 執行以下命令進入Python環境。

    python
  2. 執行以下命令匯入crcmod模組下的_crcfunext的C擴充模組。

    import crcmod._crcfunext

    出現以下錯誤提示,表明crcmod庫的C擴充模式安裝失敗。

    Traceback (most recent call last):
    File "<stdin>", line 1, in <module>
    ImportError: No module named _crcfunext                                 
  3. 根據系統內容選擇解決方案。

    Windows

    1. 下載crcmod-1.7.win32-py2.7.msi或者其他版本的.msi檔案。

      說明

      win32位的crcmod同時相容win32以及win64系統。

    2. 安裝.檔案mis並在安裝過程中指定crcmod的安裝路徑到您本地python安裝路徑下的Lib\site-packages檔案夾。例如D:\python\Lib\site-packages\

    3. 安裝完成後,再執行驗證crcmod的步驟。

    Linux

    對於Linux系統,如果出現該問題,請執行以下步驟:

    1. 執行以下命令卸載crcmod。

      pip uninstall crcmod
    2. 安裝python-devel。具體操作,請參見安裝python-devel

    3. 執行以下命令重新安裝crcmod。

      pip install crcmod

      如果執行上述步驟依然安裝失敗,卸載crcmod,然後執行以下命令查看安裝失敗的詳細原因。

      pip install crcmod -v

報錯No module named 'Crypto'

問題現象

如果執行程式時出現No module named 'Crypto'錯誤,

問題原因

不存在Crypto或存在crypto

解決方案

查看本地Python安裝路徑下的Crypto,例如D:\python3.9\Lib\site-packages

  • 如果不存在Crypto,執行以下命令。

    python -m pip install --upgrade setuptools
  • 如果存在crypto(首字母小寫),將首字母改為大寫,然後再次嘗試啟動程式。

提示“不是內部或外部命令”

Windows環境中,如果提示“不是內部或外部命令”,請在環境變數中編輯Path,增加Python和pip的安裝路徑。pip的安裝路徑一般為Python所在目錄的Scripts檔案夾。編輯環境變數後,您可能需要重啟電腦使環境變數生效。

安裝OSS Python SDK失敗

如果安裝OSS Python SDK失敗,執行以下命令卸載後重新安裝。

pip uninstall oss2            

如何升級OSS Python SDK

執行以下命令升級OSS Python SDK。

 pip install --upgrade oss2

後續步驟

安裝Python SDK後,您需要配置訪問憑證。詳情請參見配置訪問憑證