Python: 開發平台

為您的開發平台做好準備，確保流程順暢且高效

👋 歡迎瀏覽 Stackhero 文件！

Stackhero 為您提供即用型的 Python cloud 解決方案，專為簡化您的部署流程而設：

• 只需一個簡單的 git push，即可於數秒內將您的應用程式部署到生產環境。
• 支援自訂網域名稱，並為您自動配置 HTTPS 憑證，確保連線安全。
• 享有自動備份、一鍵更新及可預測收費，讓您專注於開發程式碼，而無需煩惱基礎設施管理。
• 於專屬私有基礎設施上運行，確保高效能及高安全性，您的環境將被隔離及保護。

節省時間，簡化您的工作流程：利用 Stackhero 的 Python cloud hosting，您的程式碼最快只需 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 雲端服務，運行於歐洲或美國的私有基礎設施。這個選項可快速設置，並確保您的程式碼機密性。