NewLife.Cube快速上手dotnet new cube一条命令生成项目快速开始教程【免费下载链接】NewLife.CubeWeb快速开发平台搭建管理后台灵活可扩展内部集成了用户权限管理、模板继承、SSO登录、OAuth服务端、数据导出与分享等多个功能模块在真实项目中经历过单表100亿数据添删改查的考验。项目地址: https://gitcode.com/gh_mirrors/ne/NewLife.CubeNewLife.Cube魔方是一款基于 ASP.NET Core 的Web 快速开发平台内置用户权限管理、SSO 登录、OAuth 服务端与数据导出等能力。只需执行dotnet new cube一条命令即可生成一个完整的管理后台项目数据库表自动创建、菜单自动生成编译运行后即可登录使用。本教程带你在 5 分钟内从安装模板到跑通第一个魔方管理后台。适合人群.NET 新手以及想快速搭建管理后台、内部系统的开发者。一、为什么选择 NewLife.Cube 搭建管理后台魔方NewLife.Cube的核心理念是约定优于配置你只需要定义实体和控制器列表、表单、详情、增删改查页面全部由框架自动生成并且经过真实项目单表 100 亿数据添删改查的考验。特性说明⚡ 5 分钟启动引入包后配置连接字符串即可运行默认使用 SQLite无需安装数据库 零代码 CRUD实体类自动生成完整的增删改查页面与 API 权限体系用户、角色、菜单、权限一应俱全支持控制器 Action 级控制 SSO / OAuth内置单点登录与 OAuth 服务端多端统一身份️ 多数据库支持 MySQL / SQLite / SQL Server / Oracle / PostgreSQL / 达梦等 多主题皮肤AdminLTE、Metronic、Tabler、LayuiAdmin 等NuGet 引包即切换魔方目前有两大版本按需选择版本NuGet 包架构模式适用场景第二代MVC 版NewLife.Cube.Core服务端渲染快速开发、内部系统页面开箱即用第三代WebAPI 版NewLife.Cube前后端分离自定义前端、移动端对接、微服务本教程以命令行模板方式创建MVC 版与 WebAPI 版均适用。二、环境准备如何安装 dotnet new cube 项目模板第 1 步确认 .NET SDKdotnet --version推荐 .NET 8LTS或更高版本支持 VS 2022、VS Code、Rider 等任意 .NET 开发工具。第 2 步安装魔方项目模板dotnet new install NewLife.Templates第 3 步验证模板安装成功dotnet new list在输出中能看到cube与xcode两个模板说明安装成功。如果想从源码构建或参与开发可以克隆仓库git clone https://gitcode.com/gh_mirrors/ne/NewLife.Cube三、dotnet new cube一条命令生成完整魔方项目模板安装完成后创建项目只需要一条命令# 创建完整的魔方 Web 项目 dotnet new cube --name MyWebApp # 可选创建 XCode 数据层项目仅存放实体模型 dotnet new xcode --name MyData模板命令说明cubedotnet new cube完整魔方 Web 项目含启动配置与默认主题xcodedotnet new xcodeXCode 数据层项目用于定义业务实体两个模板可以组合使用MyWebApp作为 Web 项目MyData作为独立数据层被 Web 项目引用这也是推荐的大型项目结构。四、最快启动方法dotnet run 打开管理后台进入项目目录三步跑起来cd MyWebApp dotnet build dotnet run浏览器访问终端输出的地址模板默认http://localhost:6080首次运行魔方会自动完成三件事✅ 创建数据库和表结构默认 SQLite免安装✅ 初始化系统菜单与基础数据✅ 提供默认登录入口使用默认账号登录用户名admin密码admin⚠️安全提醒魔方采用首个用户抢占管理员机制——第一个登录的用户自动成为系统管理员原admin账号随即禁用。首次登录后请立即修改密码登录成功后即可看到完整的后台管理界面用户管理、角色管理、菜单管理、日志、系统设置等模块全部开箱即用。五、生成项目后NewLife.Cube 内置了哪些能力dotnet new cube生成的不只是空壳以下核心模块在登录瞬间就已就绪1. 用户权限管理RBAC用户 → 角色 → 菜单Action 集合三层权限模型支持控制器 Action 级访问控制架构设计如下2. 多租户架构魔方原生支持多租户模式一套系统服务多个租户数据隔离与共享策略可按业务配置3. SSO 登录与 OAuth 服务端内置单点登录SSO和完整的 OAuth 服务端你的系统既能作为客户端接入外部身份体系也能反过来充当其他系统的用户中心。OAuth 服务可在后台「魔方设置 → OAuth 设置」中一键启用或禁用4. 其他内置能力数据导出与分享列表页一键导出 Excel / CSV日志审计操作日志、访问日志自动记录定时作业内置任务调度支持备份、清理等周期作业字段元数据 APIGetFields接口驱动前端动态渲染前端无需硬编码字段六、跑通之后从模板走向业务系统的 3 个方向当你想加入自己的业务时魔方提供了渐进式扩展路径无需改动框架源码实体控制器继承EntityControllerT在静态构造器中用ListFields配置列表列、搜索字段与操作按钮一个实体类即得到一个完整的管理页面含 API。视图覆写在子项目放置同路径同名的视图文件即可覆盖默认界面定制成本极低。主题皮肤切换通过 NuGet 引入皮肤包如 Metronic、Tabler、NaiveUI 等新一代前端皮肤在启动配置中一行代码切换整套 UI。相关核心代码可参考源码库中的NewLife.Cube/目录WebAPI 核心与NewLife.CubeNC/目录MVC 核心示例项目CubeDemo/与CubeSSO/演示了完整用法。七、常见问题 FAQQ需要自己安装数据库吗A不需要。默认使用 SQLite 文件数据库首次运行自动创建需要 MySQL、SQL Server 等时修改appsettings.json中的ConnectionStrings即可系统自动识别数据库类型并下载匹配驱动。Q模板安装后dotnet new list看不到 cubeA确认执行的是dotnet new install NewLife.Templates且 .NET SDK 为 8.0 及以上可用dotnet new uninstall NewLife.Templates卸载后重装。Q如何从源码获取魔方A克隆仓库git clone https://gitcode.com/gh_mirrors/ne/NewLife.Cube核心工程为NewLife.Cube第三代 WebAPI 版与NewLife.CubeNC第二代 MVC 版。Q第一个账号登录后其他账号还能用 admin 吗A不能。首个登录用户自动成为管理员原admin账号随即禁用这是魔方的安全设计。总结dotnet new install NewLife.Templates安装模板dotnet new cube --name MyWebApp一条命令生成项目dotnet run启动即可登录后台——这就是 NewLife.Cube 的全部上手路径。接下来定义你的第一个业务实体体验零代码 CRUD 的威力吧【免费下载链接】NewLife.CubeWeb快速开发平台搭建管理后台灵活可扩展内部集成了用户权限管理、模板继承、SSO登录、OAuth服务端、数据导出与分享等多个功能模块在真实项目中经历过单表100亿数据添删改查的考验。项目地址: https://gitcode.com/gh_mirrors/ne/NewLife.Cube创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考