risen 攻略

Risen工具本地环境搭建及基础使用全流程实操攻略

一、环境准备

1.1 安装Node.js版本管理器nvm

针对Mac/Linux系统，执行以下命令安装nvm：

``` curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash ```

执行后重启终端，安装并切换到Node.js 18 LTS版本：

``` nvm install 18 nvm use 18 ```

1.2 验证环境有效性

执行以下命令确认Node和npm版本符合要求：

``` node -v 输出需为v18.17.0或更高 npm -v 输出需为8.15.0或更高 ```

二、获取Risen源码并本地部署

2.1 克隆官方仓库

新建本地工作目录后进入，执行仓库克隆命令：

``` git clone https://github.com/risenjs/risen.git cd risen ```

2.2 安装项目依赖

执行npm安装命令，依赖拉取耗时1-3分钟，无报错则安装成功：

``` npm install ```

2.3 修改核心配置文件（必填）

打开项目根目录的risen.config.js，替换为以下完整可运行配置：

```javascript module.exports = { server: { port: 3000, host: '0.0.0.0' }, database: { type: 'sqlite', path: './risen.db' }, auth: { secret: 'risen-2024-local-test-key-2024' } } ```

注意：本配置仅适用于本地开发，生产环境需将secret替换为16位以上复杂字符串，数据库类型可切换为MySQL/PostgreSQL。

2.4 启动开发服务

执行启动命令，服务默认监听3000端口：

``` npm run dev ```

终端输出Server running at http://0.0.0.0:3000即为启动成功。

三、创建第一个Risen业务模块

3.1 登录管理后台

打开浏览器访问http://localhost:3000/admin，初始测试账号：admin@local.com，密码：admin123（登录后请立即修改密码）。

3.2 新建项目

点击左侧菜单「项目管理」→「新建项目」，输入项目名称：「我的第一个Risen应用」，点击「提交」。

3.3 配置页面与组件

3.3.1 新增页面

进入新建项目，点击「页面管理」→「新建页面」，页面路径：/home，模板选择「空白模板」，点击「保存」。

3.3.2 挂载文本组件

点击「组件管理」→「新建组件」，组件类型：「文本组件」，内容：「Hello Risen！本地部署验证成功」，关联页面选择刚才创建的/home，保存后页面自动渲染。

四、核心功能实操验证

4.1 访问自定义页面

在浏览器地址栏输入http://localhost:3000/home，将直接看到页面显示的文本内容。

4.2 测试API接口

点击「API管理」→「新建API」，接口路径：/api/test，方法：GET，返回内容：{"code":200,"msg":"Risen API调用成功"}，保存后执行以下命令验证接口：

``` curl http://localhost:3000/api/test ```

返回与配置一致的JSON结果即为接口正常。

五、常见问题快速排查

• 端口被占用：启动时报「EADDRINUSE」错误，修改risen.config.js中port为未被占用的端口（如3001），重新执行npm run dev。
• 依赖安装失败：执行npm cache clean --force，删除node_modules文件夹，重新执行npm install。
• 页面无法访问：检查项目是否关联对应页面，或路由路径是否与配置一致，清除浏览器缓存后重新访问。