设置 Python 开发环境

本教程介绍如何准备本地机器以进行 Python 开发，包括开发在 Google Cloud 上运行的 Python 应用。

如果您已设置开发环境，请参阅 Python 和 Google Cloud，大致了解如何在 Google Cloud 上运行 Python 应用。

目标

  • 安装最新版本的 Python。
  • 使用 venv 隔离依赖项。
  • 安装编辑器（可选）。
  • 安装 Google Cloud CLI（可选）。
  • 安装 Python 版 Cloud 客户端库（可选）。
  • 安装其他实用工具。

安装 Python

Python 的安装说明因操作系统而异。请按照您在开发环境、MacOS、Windows 或 Linux 中运行的操作系统中的说明操作。

macOS

macOS 默认包含一个 Python 版本，并将其用于自己的目的。为避免干扰 macOS，我们建议您创建一个单独的开发环境并安装最新版本的 Python。如需安装 Python，请使用 homemaker。

  1. 要使用 Homemaker 安装 Python 软件包，您需要一个编译器，该编译器可通过安装 Xcode's 命令行工具获得。

    xcode-select --install

  2. 按照 homebot 首页上的说明安装 homeblogspot，然后使用 homebot 安装 Python，如下所示：

    brew install python
pyenv install 3.9

  3. 安装完成后，验证 Python 3 是否作为 python 和 python3 可用，并且是否还安装了 pip。

    如需验证 Python 是否可用，请运行以下命令：

    python --version

    输出会显示版本。您可以在 Homecraft Python Formula 页面上了解最新版本的 Python homebot。

    如需验证 pip 是否可用，请运行以下命令：

    pip --version

    输出会显示版本。您可以通过 pip 版本说明了解 pip 的最新版本。

    Homebr 可通过 Homebot 在您的平台上安装最新版本的 Python。输出中的版本号可能与 Python 的最新官方版本不同。

Windows

  1. 如需在 Windows 环境中安装 Python，请从 Python 网站下载最新版本的 Python 安装程序。

  2. 要访问您的 Python 版本，请使用 Windows 版 Python 启动器。

    如需启动您已安装的最新版本的 Python，请运行以下命令：

    py

    如需启动您已安装的最新版本的 Python 3，请运行以下命令：

    py -3

    要验证可用的 pip 的版本，请运行以下命令：

    py -m pip --version

    输出会显示 C:\users\[USERNAME]\appdata\local\programs\python\python38-32\lib\site-packages 中的版本。

    您可以通过 pip 版本说明了解 pip 的最新版本。

Linux

大多数 Linux 发行版都包含最新版本的 Python。

  1. 如需在 Linux 环境中安装 Python，请为您的发行版安装相应的软件包。对于 Debian 和 Ubuntu，这些软件包为 python3、python3-dev 和 python3-venv。

    使用以下命令安装这些软件包：

    sudo apt update
sudo apt install python3 python3-dev python3-venv

  2. 您还需要安装 pip。虽然 Debian 和大多数其他发行版都提供了 python-pip 软件包，但我们建议您安装 pip 以获取最新版本：

    sudo apt-get install wget
wget https://bootstrap.pypa.io/get-pip.py
sudo python3 get-pip.py

  3. 安装完成后，验证您是否已安装 pip：

    pip --version

    输出会显示 /usr/local/lib/python3.x/dist-packages 中的版本。您可以通过 pip 版本说明了解 pip 的最新版本。

使用 venv 隔离依赖项

venv 是一种用于创建独立 Python 环境的工具。这些隔离环境可以具有单独的 Python 软件包版本，以便将一个项目的依赖项与其他项目的依赖项隔离开来。我们建议您在使用 Python 进行本地开发时始终使用每个项目的虚拟环境。

  1. 使用 venv 命令创建整个 Python 安装的虚拟副本。本教程在名为 env 的文件夹中创建虚拟副本，但您可以为该文件夹指定任何名称。

    macOS

    cd your-project
python -m venv env

    Windows

    cd your-project
py -m venv env

    Linux

    cd your-project
python3 -m venv env

  2. 通过激活虚拟环境，将您的 shell 设置为使用 Python 版 venv 路径。

    macOS

    source env/bin/activate

    Windows

    .\env\Scripts\activate

    Linux

    source env/bin/activate

  3. 现在，您可以在不影响其他项目或全局 Python 安装的情况下安装软件包：

    pip install google-cloud-storage

    如果您要停止使用虚拟环境并返回到全局 Python，可以将其停用：

    deactivate

如需详细了解 venv，请参阅 venv 文档。

安装编辑器

如需开发 Python 应用，您需要一个编辑器。以下是一些热门编辑器（排名不分先后）：

安装 Python 版 Cloud 客户端库

Python 开发者可通过 Python 版 Cloud 客户端库与 Datastore 和 Cloud Storage 等 Google Cloud 服务集成。如需为单个 API（例如 Cloud Storage）安装软件包，请使用类似如下的命令：

pip install --upgrade google-cloud-storage

安装 gcloud CLI

gcloud CLI 是一组适用于 Google Cloud 的命令行工具。其中包含 gcloud、gsutil 和 bq，您可以使用它们通过命令行访问 Compute Engine、Cloud Storage、BigQuery 和其他产品和服务。这些工具既能以交互方式使用，也可以在自动化脚本中运行。

后续步骤