Flask + SQLite

Python 建立網站使用心得站

整理用 Python 建網站的經驗、踩坑與實作心得,讓安裝、環境、Flask 與部署實作更容易上手。

閱讀方向

從環境建置開始,逐步整理 Flask、虛擬環境、套件管理與實戰心得。

網站管理員 ・ 2026-03-31 15:33:03 ・ 約 4 分鐘

從安裝 Python 開始:Windows、macOS、Linux 與虛擬環境入門

如果你想開始用 Python 做網站,第一步不是急著寫程式,而是先把開發環境整理好。環境只要一開始建立得穩定,後面做 Flask、SQLite、部署或維護都會順很多。對初學者來說,先把安裝、版本、虛擬環境、套件安裝這幾件事弄清楚,比一開始就追很多框架更重要。 先談安裝 Python。Windows 使用者可以直接到 Python 官網下載...

如果你想開始用 Python 做網站,第一步不是急著寫程式,而是先把開發環境整理好。環境只要一開始建立得穩定,後面做 Flask、SQLite、部署或維護都會順很多。對初學者來說,先把安裝、版本、虛擬環境、套件安裝這幾件事弄清楚,比一開始就追很多框架更重要。

先談安裝 Python。Windows 使用者可以直接到 Python 官網下載安裝程式,安裝時記得勾選「Add Python to PATH」,這樣之後在命令提示字元或 PowerShell 才能直接使用。安裝完成後,先檢查版本:

python --version
pip --version

如果你在 Windows 上輸入 `python` 沒反應,也可以試試看:

py --version
py -m pip --version

macOS 使用者如果是剛開始學習,可以直接從 Python 官網下載安裝;如果平常有用 Homebrew,也可以用 Homebrew 安裝。安裝完成後建議檢查:

python3 --version
python3 -m pip --version

若你是用 Homebrew 安裝,常見做法會是:

brew install python
python3 --version

Linux 使用者通常最方便,因為大多數發行版都可以直接用套件管理器安裝。像 Ubuntu 或 Debian 常見做法是:

sudo apt update
sudo apt install python3 python3-pip python3-venv
python3 --version
python3 -m pip --version

一開始其實不用同時裝很多 Python 版本,先裝一個穩定版本就夠了。先把一個版本用熟,比一直切版本更重要。等到之後真的遇到相容性需求,再考慮 `pyenv`、`asdf` 這類版本管理工具。

接下來是 `pip`。`pip` 是 Python 最常用的套件安裝工具,之後你要裝 Flask、Gunicorn 或其他外部程式庫,幾乎都會用到它。最基本的安裝方式如下:

python3 -m pip install flask

如果你是在 Windows,常見會寫成:

py -m pip install flask

但實務上,不建議把所有套件直接裝進系統 Python。比較穩定的做法,是先建立虛擬環境,再在虛擬環境裡安裝套件。這樣不同專案之間就不容易互相干擾。

建立虛擬環境的基本指令如下:

python3 -m venv venv

Windows 啟用方式:

venv\Scripts\activate

macOS 或 Linux 啟用方式:

source venv/bin/activate

啟用後,你安裝的 Flask、Gunicorn、Requests、SQLAlchemy 之類套件,就會進到這個虛擬環境裡,而不是污染整個系統 Python。此時可以用下面方式安裝常用程式庫:

python -m pip install flask gunicorn requests sqlalchemy

如果你只是做像本站這樣的 Flask + SQLite 小型網站,最基本會用到的套件其實不多:

python -m pip install flask gunicorn

這裡要注意,`sqlite3` 不需要另外安裝,因為它是 Python 內建模組。像本站目前的結構就是 Flask 做網站框架、SQLite 當資料庫,而正式啟動時是用 Gunicorn 來提供服務。

你也可以把目前環境需要的套件整理成 `requirements.txt`,之後要搬到其他主機或重建環境時會方便很多:

python -m pip freeze > requirements.txt
python -m pip install -r requirements.txt

不過虛擬環境不一定非得每個專案目錄都各放一份。很多人會把虛擬環境集中管理,例如放在固定目錄下,讓多個相容的專案共用同一套套件。這樣做的好處是不用每個專案都重複安裝一份大型依賴,管理起來也比較集中。像你如果有多個 Flask 網站,而且依賴版本差不多,共用虛擬環境其實是很務實的方式。

例如你可以把共用虛擬環境放在某個固定位置:

回首頁