# react-blog **Repository Path**: jiayouyc/react-blog ## Basic Information - **Project Name**: react-blog - **Description**: ai的成功案例 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-06-04 - **Last Updated**: 2025-06-30 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # React Blog 一个基于 React 18 + TypeScript + Ant Design 构建的现代化博客系统。 ## 🚀 特性 - 📝 Markdown 支持的文章编辑器 - 🔍 全文搜索功能 - 💡 评论与点赞系统 - 🎨 响应式设计 - 🔐 用户认证与授权 - 🌓 明暗主题切换 - 📱 移动端适配 - 🔥 性能优化 ## 🛠 技术栈 - **框架**: React 18 - **语言**: TypeScript - **UI 库**: Ant Design - **路由**: React Router v6 - **样式**: SCSS Modules - **HTTP 客户端**: Axios - **代码规范**: ESLint + Prettier - **构建工具**: Create React App ## 📦 安装 ```bash # 克隆项目 git clone [repository-url] # 安装依赖 npm install # 启动开发服务器 npm start # 构建生产版本 npm run build ``` ## 🏗 项目结构 ``` src/ ├── components/ # 通用组件 │ ├── Layout/ # 布局组件 │ ├── Articles/ # 文章相关组件 │ └── Common/ # 其他通用组件 ├── pages/ # 页面组件 ├── contexts/ # React Context ├── hooks/ # 自定义 Hooks ├── services/ # API 服务 ├── utils/ # 工具函数 ├── types/ # TypeScript 类型定义 ├── styles/ # 全局样式 └── App.tsx # 应用入口 ``` ## 🔨 开发指南 ### 开发环境 - Node.js >= 14.0.0 - npm >= 6.14.0 ### 可用的脚本 - `npm start`: 启动开发服务器 - `npm test`: 运行测试 - `npm run build`: 构建生产版本 - `npm run eject`: 暴露配置文件(⚠️ 不可逆操作) ### 代码规范 项目使用 ESLint 和 Prettier 进行代码规范和格式化: ```bash # 运行代码检查 npm run lint # 自动修复代码格式 npm run format ``` ## 📚 主要功能 ### 文章管理 - 文章列表展示 - Markdown 编辑器 - 文章分类和标签 - 评论系统 - 点赞功能 ### 用户系统 - 用户注册/登录 - 个人中心 - 权限管理 - 用户角色 ### 其他功能 - 响应式设计 - 主题切换 - 全局搜索 - 性能优化 ## 🔧 配置说明 主要配置文件: - `.env`: 环境变量配置 - `tsconfig.json`: TypeScript 配置 - `package.json`: 项目依赖和脚本 - `.eslintrc.js`: ESLint 规则配置 - `.prettierrc`: Prettier 格式化配置 ## 🚀 部署 ### 构建 ```bash npm run build ``` 构建后的文件将生成在 `build` 目录中。 ### 部署到生产环境 1. 配置环境变量 2. 构建生产版本 3. 部署到服务器 4. 配置 Nginx(可选) ## 📝 开发规范 ### Git 提交规范 使用语义化的提交消息: - `feat`: 新功能 - `fix`: 修复 - `docs`: 文档更新 - `style`: 代码格式 - `refactor`: 重构 - `test`: 测试 - `chore`: 构建过程或辅助工具的变动 ### 分支管理 - `main`: 主分支 - `develop`: 开发分支 - `feature/*`: 功能分支 - `hotfix/*`: 紧急修复分支 ## 🤝 贡献指南 1. Fork 本仓库 2. 创建功能分支 3. 提交更改 4. 发起 Pull Request ## 📄 许可证 [MIT License](LICENSE) ## 🙏 致谢 感谢所有为这个项目做出贡献的开发者! # 进度 src下文件夹 config