# my-vercel-flask-example

**Repository Path**: thiswind/my-vercel-flask-example

## Basic Information

- **Project Name**: my-vercel-flask-example
- **Description**: No description available
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-30
- **Last Updated**: 2025-12-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# my-vercel-flask-example

这是一个最小的 Flask 单页网站示例，演示如何将静态单页由 Flask 提供并部署到 Vercel（使用 `@vercel/python` 构建器）。

项目结构（相关文件）：
- `api/index.py` — Flask 应用（根路径渲染 `templates/index.html`，兼容 Vercel 的 Python builder）
- `templates/index.html` — 单页网站的 HTML 模板
- `requirements.txt` — 依赖清单（Flask）
- `vercel.json` — Vercel 部署配置

## 本地运行
1. 创建并激活虚拟环境（可选，但推荐）：

```bash
python3 -m venv .venv
source .venv/bin/activate
```

2. 安装依赖：

```bash
pip install -r requirements.txt
```

3. 运行本地服务：

```bash
python api/index.py
```

打开浏览器访问 http://localhost:5000/ 将看到单页网站 (HTML)，或访问 http://localhost:5000/json 获取 JSON 示例响应。

## 部署到 Vercel
1. 安装 Vercel CLI（如果尚未安装）：

```bash
npm i -g vercel
```

2. 登录并部署（交互式）：

```bash
vercel login
vercel
```

或直接生产部署：

```bash
vercel --prod
```

Vercel 会使用 `vercel.json` 中指定的 `@vercel/python` 构建器来安装 `requirements.txt` 中的依赖并将 `api/index.py` 作为 Serverless Function / WSGI 应用服务。

注意：如果 Vercel 的运行时或 builder 有更新，请参考 Vercel 官方文档以获取最新的 Python 部署指引。