Python: 开发平台

为顺畅高效的开发体验做好开发平台准备

👋 欢迎查阅 Stackhero 文档！

Stackhero 提供即开即用的 Python 云服务 方案，助您高效简化部署流程：

• 只需一次简单的 git push，即可在几秒钟内将您的应用部署到生产环境。
• 支持自定义域名，自动配置 HTTPS 证书，安全连接全程托管，无需手动操作。
• 提供自动备份、一键升级和可预测的定价，让您专注于代码开发，无需担心基础设施管理。
• 依托私有专属基础设施，为您带来强劲的性能与安全保障。您的环境完全隔离且受到保护。

节省时间，简化工作流程：通过 Stackhero 的 Python 云主机，您的代码最快只需 5 分钟即可上线运行。

一个准备充分的开发平台能够让您的工作流程更加顺畅、高效。

本指南介绍了两种高效的 Python 开发方式：使用远程、即开即用的开发环境，或在本地计算机上自行搭建环境。您还将学习如何通过 asdf 安装 Python，并从零创建一个新的 Python 项目。

如何开发：本地还是远程

您可以选择两种主要的 Python 开发方式：在本地设备上运行全部内容，或利用基于云的工作区（如 Code-Hero）。每种方式都有其明显优势。请选择最适合您工作流程和需求的方法。

本地开发 让您能够完全离线工作。如果您的网络访问受限，或需要在无网络干扰的情况下开发，这会非常有用。环境搭建需要额外时间，您还需自行负责更新、备份和系统维护。您的工作也受限于当前设备，灵活性和性能可能受到影响。

远程开发（如通过 Code-Hero）则提供了即开即用的开发环境。您可以使用一套预装工具、熟悉的界面，以及通常优于本地硬件的云端资源。只要有网络，您可以随时随地在任意设备上工作，工作区始终备份且安全。

Docker 和 Traefik 等高级功能已预先配置，您可以在开发环境中直接使用真实域名和 HTTPS。这让您能够轻松处理 Webhook、测试 CORS 策略，并在几秒钟内模拟接近生产环境的条件，无需手动配置。

便于对比：

• 本地开发（在您的计算机上）：

  • ✅ 完全离线访问：无需网络连接
  • ❌ 资源受限：受限于本地硬件性能
  • ❌ 手动配置：所有内容需自行安装和配置
  • ❌ 持续维护：更新和备份需自行负责

• 远程开发（在 Code-Hero 上）：

  • ✅ 即时环境：工具预装，立即开始开发
  • ✅ 可扩展资源：可用高性能服务器
  • ✅ 随时随地办公：任意设备、任意地点
  • ✅ 生产级测试：真实 HTTPS 域名与集成环境
  • ❌ 需要网络：需保持网络连接

您的选择取决于自身需求和偏好。如果您希望以最少配置立即开始开发，并享受设备切换的灵活性，远程方案更为理想。如果您更倾向于离线工作或有特定本地需求，本地环境可能更适合您。

Python 开发：远程方式

选择远程开发环境可以免去繁琐的手动配置。所有必需工具均已就绪，您可以在几秒钟内启动新项目。

通过 Code-Hero，您的开发工作区运行在高性能服务器上，即使是高负载项目也能流畅响应。这样，您可以专注于编写代码和实现功能，无需为依赖或环境配置耗费时间。

当您的 Code-Hero 服务启动后，您可以直接进入创建 Python 项目环节，无需执行下方的本地配置步骤。

Python 开发：本地方式

本地搭建 Python 环境意味着您需要在自己的计算机上安装运行环境、依赖和开发工具。这让您拥有完全的控制权，但也需自行负责更新、备份及环境一致性。

配置本地 Python 环境

为获得灵活且一致的环境，建议使用 asdf，这是一款多运行时版本管理工具。asdf 不仅支持 Python，还支持 Node.js、Ruby、PHP 等多种语言。它让您轻松切换不同版本，并实现项目隔离。

传统 Python 工作流依赖虚拟环境（如 python venv、virtualenv 或 mkvirtualenv）来隔离依赖。使用 asdf，您可以更稳健地管理 Python 版本和项目环境，减少摩擦，避免常见的版本冲突。

安装 asdf

请参考 asdf 官方安装指南 在您的系统上安装 asdf。

安装完成后，通过运行以下命令验证 asdf 是否配置成功：

asdf version

如果输出已安装版本号，则说明 asdf 已准备就绪。

使用 asdf 安装 Python

要添加 Python 支持并安装最新版，可执行：

asdf plugin add python https://github.com/danhper/asdf-python.git
asdf install python latest
asdf global python latest

完成后，检查 Python 版本：

python --version

该输出表明您的 Python 安装已可用于开发。

创建 Python 项目

只需几步即可启动一个新的 Python 项目：

mkdir my_project
cd my_project

为该项目指定 Python 版本并初始化 Git 仓库：

asdf install python latest \
  && asdf local python latest

echo "__pycache__/" >> .gitignore

git init
git add -A .
git commit -m "First commit"

这些命令会创建新目录，为项目配置 Python 版本，并通过首次提交启动版本控制。您可以立即开始开发。

您的 Python 项目已初始化本地 Git 仓库，但尚未连接到远程托管服务。

为确保可靠备份和便捷协作，您可以在 GitLab、GitHub 或 Bitbucket 等平台创建仓库。

如果您需要专用且安全的 Git 托管方案，Stackhero 提供 GitLab 云服务，运行于欧洲或美国的私有基础设施上。该方案支持快速部署，并保障您的代码机密性。