地端與雲端串接概念

Part 1：環境準備

從零開始，建立 Python 開發環境
安裝 Flask、OpenAI SDK 等必要套件

Python 虛擬環境 pip install .env 設定

📥 程式碼下載：GitHub

🎯 本單元學習目標

完成這個 Part 後，你將擁有一個完整的 Python 開發環境：

✅ 環境確認

確認 Python 和 pip 已正確安裝

📁 專案資料夾

建立專案目錄結構

🔒 虛擬環境

建立並啟動 venv 虛擬環境

📦 套件安裝

安裝 Flask、OpenAI、python-dotenv

💡 提示：本單元共有 12 個實作步驟，請跟著一步一步操作！

【實作 1】檢查 Python 版本

首先確認你的電腦已安裝 Python 3.8 以上版本。

📝 操作步驟

開啟 CMD（命令提示字元）
輸入以下指令：

C:\Users\你的名字> python --version

✅ 預期結果

Python 3.11.0

看到 Python 3.8 或更高版本即可繼續！

❌ 如果出現「不是內部或外部命令」
請前往 python.org 下載安裝，記得勾選「Add Python to PATH」

【實作 1】預期畫面

你的畫面應該類似上圖，顯示 Python 版本號碼。

【實作 2】檢查 pip 版本

pip 是 Python 的套件管理工具，用來安裝各種函式庫。

📝 操作步驟

在 CMD 中輸入：

C:\Users\你的名字> pip --version

✅ 預期結果

pip 23.0.1 from C:\Python311\Lib\site-packages\pip (python 3.11)

看到 pip 版本資訊即可繼續！

【實作 3】建立工作目錄

選擇一個位置存放你的專案，建議放在桌面。

📝 操作步驟

C:\Users\你的名字> cd Desktop
C:\Users\你的名字\Desktop> mkdir AI_Projects
C:\Users\你的名字\Desktop> cd AI_Projects

✅ 預期結果

C:\Users\你的名字\Desktop\AI_Projects>

💡 說明：
cd = 切換目錄（Change Directory）
mkdir = 建立資料夾（Make Directory）

【實作 4】建立專案資料夾

在 AI_Projects 裡面，建立本章的專案資料夾。

📝 操作步驟

C:\...\AI_Projects> mkdir ch2_local_ai_app
C:\...\AI_Projects> cd ch2_local_ai_app

✅ 預期結果

C:\Users\你的名字\Desktop\AI_Projects\ch2_local_ai_app>

現在你在專案資料夾中，接下來的所有操作都在這裡進行！

【實作 5】建立虛擬環境

虛擬環境讓每個專案的套件互不干擾，是 Python 開發的好習慣。

📝 操作步驟

C:\...\ch2_local_ai_app> python -m venv venv

💡 說明：
python -m venv venv = 使用 Python 的 venv 模組，建立名為 venv 的虛擬環境

⏳ 等待時間

這個步驟需要 10-30 秒，請耐心等待。完成後資料夾中會出現 venv 資料夾。

【實作 6】啟動虛擬環境

建立後要「啟動」虛擬環境才能使用。

📝 Windows CMD 指令

C:\...\ch2_local_ai_app> venv\Scripts\activate

📝 Windows PowerShell 指令

venv\Scripts\Activate.ps1

✅ 預期結果

(venv) C:\...\ch2_local_ai_app>

🎉 成功！看到提示符前面的 (venv) 表示虛擬環境已啟動！

【實作 6】預期畫面

⚠️ PowerShell 權限錯誤？
如果出現錯誤，請先執行：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

【實作 7-9】安裝必要套件

確認 (venv) 已顯示後，依序安裝三個套件：

【實作 7】安裝 Flask

(venv) C:\...> pip install flask

【實作 8】安裝 OpenAI SDK

(venv) C:\...> pip install openai

【實作 9】安裝環境變數工具

(venv) C:\...> pip install python-dotenv

每個安裝大約需要 10-30 秒，會顯示很多下載訊息，這是正常的！

【實作 10】確認套件安裝

安裝完成後，確認所有套件都已正確安裝。

📝 操作步驟

(venv) C:\...> pip list

✅ 預期結果（部分）

Package         Version
--------------- -------
flask           3.0.0
openai          1.6.1
python-dotenv   1.0.0
...

看到 flask、openai、python-dotenv 即表示安裝成功！

【實作 10】預期畫面

【實作 11】建立 .env 檔案

這個檔案用來安全地儲存你的 API Key。

📝 操作步驟

在 ch2_local_ai_app 資料夾中建立新檔案
檔名：.env（注意開頭有一個點）
輸入以下內容：

OPENAI_API_KEY=sk-proj-你的真實API金鑰

🟥 重要警告：
這個檔案包含你的 API 密鑰，絕對不要上傳到 GitHub！

【實作 12】建立 .gitignore 檔案

告訴 Git 忽略某些檔案，避免不小心上傳敏感資料。

📝 操作步驟

在同一個資料夾建立 .gitignore 檔案
輸入以下內容：

venv/
.env
__pycache__/
*.pyc

💡 說明：
venv/ = 忽略虛擬環境資料夾
.env = 忽略環境變數檔案（含 API Key）
__pycache__/ = 忽略 Python 快取

✅ Part 1 完成確認

完成所有步驟後，你的專案資料夾結構應該如下：

ch2_local_ai_app/
├── venv/              ← 虛擬環境資料夾
├── .env               ← API Key 設定檔
└── .gitignore         ← Git 忽略清單

✅ 檢查清單

☐ CMD 顯示 (venv) 標記
☐ pip list 顯示 flask、openai、python-dotenv
☐ .env 檔案已建立並填入 API Key
☐ .gitignore 檔案已建立

🎉 恭喜！環境準備完成，可以進入 Part 2：Flask 基礎實作！

← 返回課程首頁