介绍

CatchAdmin 是一款基于 Laravel 13.x 和 Vue3 二次开发的 PHP 开源后台管理系统，采用前后端分离架构，面向企业级后台场景，提供了一套开箱即用、可持续扩展的后台基础框架。

它内置了后台系统常用的一整套能力，包括 Token 鉴权、权限管理、动态路由、动态表格、分页封装、资源权限控制、上传下载、代码生成器、数据回收站、附件管理等。无论是做内部管理系统，还是快速交付业务后台，都可以直接站在这套基础能力上继续开发，少写很多重复代码。

在权限体系上，CatchAdmin 支持菜单权限、按钮权限和数据权限，能够覆盖大部分企业后台的权限控制需求。配合动态路由和资源权限控制，可以让不同角色、不同用户看到不同的菜单、页面和数据范围。

架构设计上，Laravel 主要作为 API 服务层对外提供接口，业务模块之间尽量保持低耦合。每个模块都有独立的控制器、路由、模型和数据表结构，支持按模块拆分、按需加载、独立迭代。这样一来，无论后期是扩展 CMS、CRM、OA，还是沉淀成企业内部业务平台，都不会很快陷入 “代码越写越粘” 的状态。

同时，项目还封装了大量后台开发中高频使用的通用能力，比如统一响应、异常处理、分页封装、资源输出、代码生成等，让开发者可以把更多精力放在业务本身，而不是反复搭后台基础设施。

简单来说，基于 CatchAdmin，你可以比较快地搭建出一套稳定、规范、可扩展的管理系统，并在此基础上继续沉淀自己的业务模块。

V5.3.1 版本亮点

这次 V5.3.1 的重点，主要修复一些小问题

• 后台前端样式全面升级到 tailwindcss4 和 vite8，打包实践降到 10s 内
• 优化更新数据时所有者的归属问题
• 修复部门及以下得数据问题
• 优化核心包树形组件得性能问题
• 修复 tinymce 组件加载问题
• 更多细节更新持续补充中

如果本地没有该命令，需要先将 catchadmin/core 更新到 1.3.2：

composer update catchadmin/core

快速开始

# 创建项目
composer create-project catchadmin/catchadmin

# 安装项目
cd catchadmin && php artisan catch:install

# 启动项目
composer run dev

🤖 使用 AI 开发

CatchAdmin 对 AI 开发场景做了系统性支持，内置了 AI 相关的开发指引、Skills 与 MCP 文档能力。这让 Cursor、Claude Code、Codex、Windsurf 等 AI 编码助手能够更准确地理解项目结构、模块规范和开发方式，显著减少反复解释项目上下文的时间。

你可以将以下常见后台开发任务交给 AI 完成

• 根据表结构生成 CRUD 模块
• 根据 SQL 生成后端接口和前端页面
• 查询项目模块结构
• 生成菜单、权限、路由相关代码
• 辅助安装项目
• 快速定位开发规范与最佳实践

Skills 扩展

CatchAdmin 支持通过 Skills 的方式封装常用 AI 能力，把安装、代码生成、前端开发、SQL to CRUD 等高频任务标准化。

这意味着你不需要每次都从零开始告诉 AI “这个项目怎么写模块”“接口怎么返回”“前端页面怎么组织”。项目会把这些约定沉淀到 Skills 中，让 AI 更容易按 CatchAdmin 的规范来生成代码。

AGENTS.md 标准

项目兼容 AGENTS.md 规范，方便 AI 编码助手自动理解项目目录、模块划分、开发约定和注意事项。

对于使用 Cursor、Claude Code、Codex 这类工具的开发者来说，AGENTS.md 可以帮助 AI 在写代码前先 “读懂项目”，减少跑偏、乱生成、不符合项目结构的问题。

实时文档获取：Context7 MCP

CatchAdmin 文档已经接入 Context7 提供的 MCP 服务。

开发者可以通过 Context7/mcp 客户端实时获取 CatchAdmin 最新技术文档、API 说明和最佳实践。不需要来回翻文档，也不用担心 AI 拿到的是旧上下文，在 IDE 或 AI 对话里就能直接拉取最新资料，提高开发效率。

通过 AI 安装项目

如果你想让 AI 帮你完成项目安装，可以先正常安装项目依赖：

composer install

依赖安装完成后，执行下面的命令发布对应平台的 Skills：

php artisan catch:publish:skills

目前已支持 Codex、Claude、Cursor 等多个 AI 编码平台，你可以根据自己实际使用的工具选择安装对应 Skills。

发布完成后，在 AI 对话框中直接发送类似下面的内容即可：

安装项目，数据库配置是
DB_DATABASE=数据库名称
DB_USERNAME=用户名
DB_PASSWORD=密码

AI 会根据项目内置的安装指引和 Skills，帮助你完成后续安装流程。对于刚接触项目的开发者来说，这种方式可以少踩不少环境配置和安装步骤上的坑。

功能清单

• ☑️ 用户管理：支持用户添加、修改、删除，并可为不同用户配置不同后台首页
• ☑️ 部门管理：支持公司、部门、小组等组织结构管理，以树形结构展示
• ☑️ 岗位管理：支持为用户配置岗位和职务信息
• ☑️ 角色管理：支持角色树结构设计，可分配菜单权限、按钮权限和数据权限
• ☑️ 菜单管理：支持系统菜单、按钮和权限标识配置
• ☑️ 字典管理：统一维护系统中常用的固定数据，方便复用
• ☑️ 系统配置：管理后台常用配置项
• ☑️ 操作日志：记录并查询用户正常操作行为
• ☑️ 登录日志：记录用户登录情况，方便审计和排查问题
• ☑️ 文件上传：支持本地、七牛云、阿里云、腾讯云等存储方式
• ☑️ 附件管理：统一管理系统上传的文件和图片
• ☑️ 数据表维护：支持数据表碎片清理、优化、回收和销毁
• ☑️ 代码生成：支持生成 PHP、Vue、数据库迁移等前后端代码，并可一键生成到指定模块
• ☑️ Vue 即时渲染：支持前端 Vue 即时渲染，无需额外编译
• ☑️ 插件系统：CatchAdmin 插件即 Composer 包，天然融入 Composer 生态

在线体验

演示地址：https://v5.catchadmin.com

超管账户

• 账户：catch@admin.com
• 密码：catchadmin

测试账户

• 账户：test@admin.com
• 密码：Testadmin1

项目地址

• GitHub：https://github.com/JaguarJack/catch-admin
• Gitee：https://gitee.com/catchadmin/catchadmin

项目预览

写在最后
CatchAdmin V5.3.1 在提供稳定后台基础框架的同时，进一步强化了构建效率与 AI 开发体验。通过 Tailwind CSS v4 与 Vite 8 的前端升级，打包体验更轻更快；通过一系列问题修复，系统运行更加稳定。配合 Skills、AGENTS.md 和 Context7 MCP，AI 能够真正理解项目规范，帮你高效完成模块创建、CRUD、权限、菜单等标准化工作。

如果你正在寻找一套免费可商用、可扩展、适合长期维护的 PHP + Vue 后台框架，不妨试试 CatchAdmin V5.3.1。