Python后端开发入门：从环境搭建到第一个API接口

这种说法看似合理，因为多数商业业务系统最终都依赖数据库保存状态。但从网络架构的角度看，这并不完全准确。后端的本质是网络通信协议的接收与状态调度中心。

数据库只是后端系统的持久化存储介质，很多真实的后端接口（例如天气预报代理、即时计算公式、权限验签网关）根本无需操作数据库。后端的首要职责是维持网络通信的稳定性、校验传入数据的合法性，以及按照接口契约（API Contract）稳定输出规范结果。

在单个小型学习脚本阶段，这种做法确实能够跑通。然而，一旦进入后端开发领域，这种习惯会迅速埋下隐患。

不同项目对第三方包版本的依赖各不相同（例如项目 A 依赖特定旧版本，项目 B 依赖新特性）。如果全部安装到全局环境，包的升级将直接引发难以排查的项目崩溃。此外，现代云服务器部署要求精简、透明的依赖清单（如 requirements.txt）。建立虚拟环境（Virtual Environment）是所有规范后端工程的法定第一步。

# 1. 创建并进入工程文件夹
mkdir my_backend_app
cd my_backend_app

# 2. 检查 Python 版本（要求 Python 3.8 或更高版本）
python3 --version

# 3. 使用内置 venv 模块创建名为 .venv 的虚拟环境
python3 -m venv .venv

Python 3.10.12

# macOS / Linux 系统执行：
source .venv/bin/activate

# Windows (PowerShell) 环境执行：
# .venv\Scripts\Activate.ps1

# Windows (CMD) 环境执行：
# .venv\Scripts\activate.bat

pip install fastapi uvicorn

from typing import Optional
from fastapi import FastAPI

# 1. 实例化核心应用对象
app = FastAPI(
    title="My First API",
    description="入门 Python 后端开发示例服务",
    version="1.0.0"
)

# 2. 根路由：系统健康度检测接口
@app.get("/")
def read_root():
    """
    HTTP GET 根路径
    返回服务基础运行状态
    """
    return {
        "status": "online",
        "service": "python-backend-starter",
        "code": 200
    }

# 3. 业务路由：接收查询参数并处理返回
@app.get("/api/greet")
def greet_user(name: str = "Developer", count: Optional[int] = 1):
    """
    HTTP GET 欢迎信息接口
    - name: 字符串类型参数，提供默认值
    - count: 整数类型参数，自动进行数据类型转换与验证
    """
    messages = [f"Hello, {name}! Welcome to Python Backend."] * max(1, count)
    return {
        "success": True,
        "recipient": name,
        "requested_count": count,
        "messages": messages
    }

uvicorn main:app --reload --host 127.0.0.1 --port 8000

INFO:     Will watch for changes in: ['/path/to/my_backend_app']
INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
INFO:     Started reloader process [18920] using WatchFiles
INFO:     Started server process [18922]
INFO:     Waiting for application startup.
INFO:     Application startup complete.

curl -s http://127.0.0.1:8000/

{"status":"online","service":"python-backend-starter","code":200}

curl -s "http://127.0.0.1:8000/api/greet?name=Alice&count=2"

{
  "success": true,
  "recipient": "Alice",
  "requested_count": 2,
  "messages": [
    "Hello, Alice! Welcome to Python Backend.",
    "Hello, Alice! Welcome to Python Backend."
  ]
}