# live_qrcode

**Repository Path**: yoowater/live_qrcode

## Basic Information

- **Project Name**: live_qrcode
- **Description**: Python web二维码活码工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-01
- **Last Updated**: 2026-03-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Python活码工具

**测试运行环境**：python 3.12.10

## 项目结构

```txt
live_qrcode/               # 项目根目录
├── app/                   # 核心应用包（所有业务逻辑都在这里）
│   ├── __init__.py        # 应用初始化（创建 Flask 实例、注册路由等）
│   ├── config.py          # 配置文件（存储目录、数据库等配置项）
│   ├── db/                # 数据库相关模块
│   │   ├── __init__.py
│   │   └── operations.py  # 数据库初始化、增删改查等操作
│   ├── qrcode/            # 二维码相关模块
│   │   ├── __init__.py
│   │   └── generator.py   # 二维码生成、保存、下载等功能
│   └── routes/            # 路由视图模块（处理网页请求）
│       ├── __init__.py
│       └── views.py       # 所有 Flask 路由和页面渲染逻辑
├── qrcodes/               # 自动生成：存储二维码图片（运行后创建）
├── live_qrcode.db         # 自动生成：SQLite 数据库文件（运行后创建）
├── requirements.txt       # 项目依赖清单
└── run.py                 # 项目启动入口（外部启动文件，简洁干净）
```



## 构建、运行

```bash
# 1. 初始化虚拟环境(同时升级ensurepip捆绑pip等依赖)
python -m venv .venv --upgrade-deps

# 2. 激活虚拟环境(Windows)
.venv\Scripts\activate
# Mac/Linux
source .venv/bin/activate

# 3. 安装依赖
pip install -r requirements.txt

# 4. 运行项目
python run.py
```



## 其他

**依赖文件：requirements.txt**

```txt
# 项目核心依赖
Flask>=2.0.0,<3.0.0
qrcode>=7.3.1,<8.0.0
Pillow>=9.0.0,<11.0.0

# 可选依赖（如需扩展或优化，可安装）
# sqlite3 是 Python 内置模块，无需额外安装
```



**初始化依赖**

```bat
# 初始化方式1
pip install flask qrcode pillow -i https://pypi.tuna.tsinghua.edu.cn/simple


# 初始化方式2
pip install -r requirements.txt
## 或
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
```

**运行**

```bat
# 运行
python run.py

# 运行单文件版
python app.py
```

**脚本构建&运行**

```bat
@echo off
title Python Web

chcp 65001 > nul
echo ==============================================
echo 初始化Python虚拟环境、安装依赖并运行项目...
echo ==============================================

rem 创建虚拟环境
python -m venv venv

rem 激活虚拟环境（bat中必须用call调用activate，否则激活后会直接退出脚本）
call venv\Scripts\activate.bat

rem 激活成功后执行python命令
if %errorlevel% equ 0 (
    pip install -r requirements.txt

    echo ==============================================
    python run.py
) else (
    echo 【错误】虚拟环境激活失败，请检查venv目录是否存在！
    echo 检查路径：%cd%\venv\Scripts\activate.bat
)

rem 执行完成后保持窗口不关闭（按任意键退出，可根据需要删除）
echo ==============================================
echo 程序执行完成，按任意键退出...

pause > nul
```

**打包程序**

```bat
# requirements.txt追加打包工具依赖
PyInstaller>=5.0.0,<6.0.0

# 虚拟环境中重新构建并执行
pyinstaller --onefile --name live_qrcode_app --add-data "app;app" --add-data "qrcodes;qrcodes" run.py
```