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 開發：遠端方式

選擇遠端環境進行 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 雲端服務，運行於歐洲或美國的私有基礎設施。此選項可快速建置，並確保您的程式碼機密性。