shumengya/QuickStack

Fork 0

Files

树萌芽 7ce1e58a6e first commit

2026-02-14 00:46:04 +08:00

4.6 KiB

Raw Blame History

QuickStack - 前后端分离项目初始化工具

🚀 QuickStack - 一款强大的全栈项目初始化工具，让你在几秒钟内搭建好前后端分离的开发环境。

✨ 功能特性

多种前端框架支持: React, Vue
丰富的后端选择: Go(标准库/Gin), Python(Flask/FastAPI/Django), Java(Spring Boot), JavaScript(Express.js/NestJS)
集成 Tailwind CSS: 一键配置现代化的 CSS 框架
自动生成启动脚本: Windows BAT 脚本，双击即可启动项目
跨域配置: 所有后端模板均已配置 CORS，前后端联调无障碍
交互式 CLI: 友好的命令行交互界面

📦 支持的技术栈

前端框架

⚛️ React (Vite + React)
💚 Vue (Vite + Vue)

后端框架

🐹 Go (标准库 http)
🚀 Go (Gin 框架)
🐍 Python (Flask)
⚡ Python (FastAPI)
🎯 Python (Django)
☕ Java (Spring Boot)
🟨 JavaScript (Express.js)
🐈‍⬛ JavaScript (NestJS)

🔧 环境要求

Python 3.8+
Node.js 16+ (前端项目和 JS 后端需要)
Go 1.18+ (Go 后端需要)
Java 17+ 和 Maven 3.6+ (Spring Boot 后端需要)

🚀 使用方法

1. 克隆项目

git clone <your-repo-url>
cd QuickStack

2. 运行初始化脚本

python main.py

3. 按照提示操作

输入项目名称（英文）
选择前端框架（React/Vue）
选择是否使用 Tailwind CSS
选择后端框架

4. 启动项目

进入生成的项目目录，双击运行：

开启前端.bat - 启动前端开发服务器
开启后端.bat - 启动后端服务
构建前端.bat - 构建前端生产版本

📁 项目结构

QuickStack/
├── main.py              # 主程序入口
├── utils.py             # 工具函数
├── directory.py         # 目录管理
├── scripts.py           # 启动脚本生成
├── frontend/            # 前端模块
│   ├── react.py         # React 初始化
│   ├── vue.py           # Vue 初始化
│   └── tailwind.py      # Tailwind CSS 配置
├── backend/             # 后端模块
│   ├── golang.py        # Go 初始化
│   ├── python_flask.py  # Flask 初始化
│   ├── python_fastapi.py# FastAPI 初始化
│   ├── python_django.py # Django 初始化
│   ├── java_spring.py   # Spring Boot 初始化
│   ├── js_express.py    # Express.js 初始化
│   └── js_nestjs.py     # NestJS 初始化
└── README.md            # 项目说明

🎯 生成的项目示例

myproject/
├── myproject-frontend/     # 前端项目
│   ├── src/
│   ├── package.json
│   └── ...
├── myproject-backend/      # 后端项目
│   ├── src/ 或 main.go 等
│   └── ...
├── 开启前端.bat            # 启动前端
├── 开启后端.bat            # 启动后端
└── 构建前端.bat            # 构建前端

🔌 API 端点

所有后端模板都包含健康检查端点：

GET http://localhost:8080/api/health

响应示例：

{
  "status": "ok",
  "message": "Welcome to myproject API"
}

⚙️ 自定义配置

Tailwind CSS

如果选择使用 Tailwind CSS，会自动：

安装 tailwindcss、postcss、autoprefixer
初始化配置文件
更新 CSS 文件
创建示例组件

CORS 跨域

所有后端模板均已配置 CORS，允许：

来源: * (所有域名)
方法: GET, POST, PUT, DELETE, OPTIONS
请求头: Content-Type, Authorization 等

📝 注意事项

Windows 专用: 本项目生成的启动脚本是 .bat 格式，专用于 Windows 系统
Python 虚拟环境: Python 后端会自动创建虚拟环境并安装依赖
npm 依赖: 前端项目会自动安装 npm 依赖
端口: 后端服务默认运行在 8080 端口

🐛 常见问题

Q: 前端项目创建失败？

A: 请确保已安装 Node.js (16+) 和 npm，并检查网络连接。

Q: Python 后端依赖安装失败？

A: 请确保 Python 环境正常，并检查 pip 是否可用。可以手动进入目录运行 pip install -r requirements.txt。

Q: 如何修改默认端口？

A: 修改后端项目的配置文件或代码中的端口设置即可。

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 许可证

MIT License

💖 致谢

感谢使用 QuickStack！祝开发愉快！

QuickStack - 让全栈开发更简单 🚀

4.6 KiB Raw Blame History Unescape Escape