Skill 多語言閱讀指南
hf-cloud-python-env-setup用途、用法與原始來源
為 SageMaker / AWS 工作建立一個獨立的 Python 環境，並安裝正確的 Python 版本和最新的 boto。3每當需要在 SageMaker 部署、訓練作業或任何 AWS 自動化過程中執行 Python 程式碼時，包括即將運行時，都應使用此技能。pip install即將調用boto3建立或啟動虛擬環境時，或使用者要求「設定環境」時，切勿使用系統 Python，也切勿pip install深入研究。始終進行隔離。這項技能可以避免最常見的故障模式：Python 版本錯誤、依賴衝突和過時的 SDK。
原文擷取時間:
- 來源儲存庫
- huggingface/skills
- SKILL.md
skills/hf-cloud-python-env-setup/SKILL.md- 儲存庫 Star
- 11,241
- 儲存庫最近更新
- 2026-10-30
- 能力分類
- 雲端服務
- 最近採集時間
授權：Apache-2.0
流程片段用來協助閱讀上游說明。本頁沒有執行第三方 Skill，不屬於實測評測。
下面的用途與操作片段來自上游文件，由本站整理並翻譯，和另行標示的 Codez 編輯分析分開呈現。
這個 Skill 能做什麼
為 SageMaker / AWS 工作建立一個獨立的 Python 環境，並安裝正確的 Python 版本和最新的 boto。3每當需要在 SageMaker 部署、訓練作業或任何 AWS 自動化過程中執行 Python 程式碼時，包括即將運行時，都應使用此技能。pip install即將調用boto3建立或啟動虛擬環境時，或使用者要求「設定環境」時，切勿使用系統 Python，也切勿pip install深入研究。始終進行隔離。這項技能可以避免最常見的故障模式：Python 版本錯誤、依賴衝突和過時的 SDK。
如何使用：上游操作流程
如何設定
最快的方法是使用捆綁的腳本——它是用 Python 編寫的，因此在 Windows、macOS 和 Linux 上運行效果相同：該腳本可以檢測…uv如果可用則使用（速度更快），否則回退到標準庫。venv模組，創建.venv/使用 Python3.12（覆蓋：python3 setup_env.py .venv 3.11拒絕不支援的 Python 版本，從捆綁包安裝requirements.txt並且是冪等的。它還會列印出宿主作業系統的正確解釋器路徑（見下文）。設定完成後，請明確呼叫環境中的 Python，而不是啟動虛擬環境。解譯器路徑因平台而異：這在腳本、互動式 shell 和代理工具呼叫中都適用。此技能的其餘部分會寫入.venv/bin/python為簡潔起見－在 Windows 替代.venv\Scripts\python.exe。
python3 scripts/setup_env.py # macOS / Linux
python scripts/setup_env.py # Windows (PowerShell / cmd)環境與相依需求
SageMaker 的 Python 環境配置
大多數看似AWS問題的SageMaker部署失敗其實是Python環境問題：Python版本錯誤、相依性解析錯誤、過時的SDK無法辨識最新的API。掌握這項技能可以讓環境配置變得簡單又正確。
原文片段 · L6 ↗限制與結果檢查
常見陷阱
神秘pip install解析錯誤幾乎總是 Python3.13+ 嘗試安裝尚未安裝 wheel 套件的軟體包，或安裝到已污染的 Python 系統中。請重現此問題。3.12： 刪除.venv並重新運行python3 setup_env.py .venv 3.12（當版本不匹配時，腳本會重新建立環境，因此您也可以直接重新運行它）。pip install安裝成功，但腳本提示「找不到模組」。您安裝的 Python 解釋器與執行腳本的解釋器不同。請始終顯式調用 Python：.venv/bin/python -m pip install ...和.venv/bin/python deploy.py。
核心規則
永遠不要使用系統自備的 Python。始終在隔離的環境中工作。鎖定 Python 版本，而不是軟體包版本。3.10，3.11， 或者3.12。 避免3.13+ — 機器學習函式庫的 wheel 套件可用性有滯後，依賴關係解析也容易出現令人困惑的問題。請安裝每個軟體包的最新版本。不要過度依賴版本控制。boto3或者awscli新版本具備最新的 API 介面和安全修復。僅當使用者明確要求特定版本時才鎖定版本。請正確檢查已安裝的版本。importlib.metadata.version("package-name")， 絕不module.__version__後者在不同的軟體包中並不一致。
開始使用前
- 先核對支援的 Agent 宿主和儲存庫安裝說明。保留完整 Skill 目錄及其引用的腳本、資源和文件，只複製 SKILL.md 可能遺漏相依需求。
- 向 Agent 提供實際輸入、預期輸出和驗收標準。呼叫方式與可用工具取決於宿主環境，本站不假定存在通用的安裝指令。
- 先在暫存專案或輸入副本上試用。涉及修改檔案、遠端服務或計費資源的操作，應逐項核對後再授權。
- 依照原文檢查項目和自己的需求驗證輸出。成功觸發或儲存庫 Star 較高，都不能證明結果正確。
繼續閱讀原始文件
相關 Skill
翻譯與介紹範圍
本頁從固定版本的上游 SKILL.md 整理用途與操作片段，譯文使用輔助翻譯。它不是完整手冊，也不代表經過相容性實測；使用前請核對原文及其引用檔案。
介紹依據下方列出的固定版本；目前儲存庫動態和目錄擷取時間分開呈現。
- 固定版本來源
- 閱讀原文 ↗
- 原文擷取時間
- 來源提交版本
fabc634a893f62ad5c2039830397efa35fa62715- 原文 SHA-256
c5d108b134dc5237ec63fbbb3200717853f2c5281ab33b7a2f1576b46a4d0fe8