【Microi 吾码】基于 Microi 吾码低代码框架构建 Vue 高效应用之道

优质文章学习记录

10 Apr 2026 — 10 min read

我的个人主页
文章专栏：Microi吾码

引言

在当今快速发展的软件开发领域，低代码开发平台正逐渐崭露头角，为开发者们提供了更高效的应用构建途径。Microi 吾码低代码框架结合 Vue的强大前端能力，更是为打造高效应用提供了绝佳的组合。在这里，我将深入探讨如何基于 Microi 吾码低代码框架构建 Vue 高效应用。

Microi吾码官网： https://microi.net
GitEE开源地址： microi.net:

一：Microi吾码安装指南

1、系统要求

操作系统：支持Windows、Linux等主流操作系统。
数据库：需要安装并配置支持的数据库，如MySql5.5+、SqlServer2016+、Oracle11g+等。
其他软件：安装.NET 8 SDK、Redis，并且最好安装Git用于代码获取。对于一些高级功能，可能还需要安装Docker、MinIO、MongoDB、RabbitMQ、ES等软件。

2、获取Microi吾码代码

使用Git克隆代码库
- 打开命令行工具（如Windows的CMD或Linux的Terminal）。
- 输入以下命令来克隆Microi吾码的代码仓库（以Gitee为例）：
  - git clone https://gitee.com/ITdos/microi.net
- 这将在本地创建一个名为microi.net的文件夹，其中包含Microi吾码的所有源代码。

3、后端安装与配置

打开解决方案文件
- 使用Visual Studio Code或者Visual Studio 2022打开克隆下来的microi.net文件夹中的解决方案文件（.sln文件）。
配置appsettings.json文件
- 在Microi.net.Api项目中找到appsettings.json文件，这是后端服务的主要配置文件。
- 配置AppSettings部分的关键参数：
  - OsClient：自定义SaaS引擎Key，要与数据库sys_osclient表的OsClient字段值对应，例如可以设置为iTdos。
  - OsClientType：自定义程序运行环境，如Product（正式环境）、Dev（测试环境）等。
  - OsClientNetwork：自定义网络类型，如Internet（公网）、Internal（内网）等。
  - OsClientDbConn：数据库连接字符串。如果使用MySQL，格式大致为server=your_server;user=your_user;password=your_password;database=your_database。对于SqlServer和Oracle，也有相应的格式要求。
  - IS4SigningCredential：可以直接使用源码中的默认签名。
  - Redis配置（可选）：
    - 如果【OsClient + OsClientType + OsClientNetwork】在【sys_osclient】表中不能匹配到数据（或者匹配的数据中没有Redis相关配置），需要配置以下Redis参数。
    - OsClientRedisHost：Redis主机地址，例如119.31.116.88。
    - OsClientRedisPort：Redis端口，如6379。
    - OsClientRedisPwd：Redis密码，如123456。
  - 其他配置（如分布式存储、MQ消息队列、ES搜索引擎等）：可以在平台的【SaaS引擎】中动态配置。

4、前端安装与配置

安装前端依赖
- 进入前端项目目录，如microi.vue2.pc或microi.vue3（具体目录根据实际情况而定）。
- 查看该目录下的package.json文件，然后在命令行中执行npm install（如果使用yarn则执行yarn install）来安装所有依赖的JavaScript库。
配置接口地址
- 在前端项目的配置文件（通常是src/config.js或类似文件）中，找到与后端接口地址相关的配置项。
- 将其修改为后端服务实际运行的地址和端口，例如http://localhost:5000（假设后端服务在本地的5000端口运行），确保前端能够正确地与后端进行通信。

5、数据库初始化

创建数据库
- 使用你选择的数据库管理工具（如MySQL Workbench对于MySQL数据库）创建Microi吾码所需的数据库。
- 数据库名称等信息要与appsettings.json文件中配置的OsClientDbConn中的数据库名称一致。
导入初始数据
- 在项目的源代码中找到数据库初始化脚本或相关的SQL文件。这些文件可能在database文件夹或者类似的目录下。
- 在创建好的数据库中执行这些脚本，以创建必要的表结构、存储过程以及初始数据等。

6、启动项目

后端启动
- 在Visual Studio Code或Visual Studio 2022中，右键点击Microi.net.Api项目，选择调试 -> 启动新实例，启动后端服务。
前端启动
- 在前端项目目录下，执行npm run serve（如果使用yarn则执行yarn serve）启动前端开发服务器。
- 等待编译完成后，在浏览器中访问前端项目的地址（通常是http://localhost:8080），就可以看到Microi吾码的登录界面了。

注意，在安装过程中，如果缺少某些必要的软件环境（如没有MongoDB环境会影响系统日志功能，没有MinIO或阿里云OSS等分布式存储环境会影响文件/图片上传功能等），相关功能可能无法正常使用。

二、Microi 吾码低代码框架与 Vue 简介

Microi 吾码低代码框架是一款旨在简化应用开发流程的工具，它通过可视化的界面设计、预制的组件库以及自动化的代码生成机制，让开发者能够快速搭建应用的基础架构。而 Vue 作为一款流行的前端 JavaScript 框架，以其简洁、灵活、高效的特点，在前端开发中占据重要地位。它采用组件化的开发模式，使得代码复用性极高，并且在数据绑定和响应式设计方面表现出色。

Microi 吾码采用.NET8 + Redis + MySql/SqlServer/Oracle + Vue2/3 + Element-UI/Element-Plus 技术框架，于 2014 年开始创建，2018 年使用 Vue 重构，并在 2024 年 10月 29 日开源。

二、项目初始化

我们需要创建一个基于 Microi 吾码低代码框架的项目，并集成 Vue。假设我们已经安装好了 Microi 吾码的开发环境，在命令行中执行以下命令创建项目：

microi create my-app

这将创建一个名为my-app的项目目录，包含了项目的基本结构和配置文件。进入项目目录后，我们需要安装 Vue 相关的依赖：

cd my-app npminstall vue

三、创建 Vue 组件

在 Microi 吾码低代码框架中，我们可以方便地创建 Vue 组件。例如，我们创建一个简单的HelloWorld组件。在项目的src/components目录下创建一个HelloWorld.vue文件，代码如下：

<template> <div> <h1>{{ message }}</h1> </div> </template> <script> export default { name: 'HelloWorld', data() { return { message: 'Hello, Microi and Vue!' } } } </script> <style scoped> .hello-world { background-color: #f5f5f5; padding: 20px; border-radius: 5px; } </style>

这个组件非常简单，它在页面上显示一个带有指定消息的标题，并设置了一些基本的样式。

四、在 Microi 吾码页面中使用 Vue 组件

平台效果

在 Microi 吾码的页面设计器中，我们可以像使用普通组件一样使用我们创建的 Vue 组件。打开项目中的页面文件（例如src/pages/HomePage.vue），在template部分添加以下代码：

<template> <div> <HelloWorld /> </div> </template> <script> import HelloWorld from '@/components/HelloWorld.vue'; export default { components: { HelloWorld } } </script>

这里我们首先导入了HelloWorld组件，然后在components选项中注册它，最后在template中使用它。这样，当我们运行应用时，就会在页面上看到HelloWorld组件显示的内容。

五、数据交互与绑定

Vue 的核心优势之一是数据绑定和响应式设计。在 Microi 吾码低代码框架中，我们可以充分利用这一特性实现数据的动态交互。例如，假设我们有一个数据列表，我们希望在页面上动态显示并能够根据用户操作进行更新。

在src/store目录下创建一个dataStore.js文件，用于存储数据：

import Vue from'vue';exportconst dataStore =newVue({data(){return{itemList:[{id:1,name:'Item 1',description:'Description of Item 1'},{id:2,name:'Item 2',description:'Description of Item 2'},{id:3,name:'Item 3',description:'Description of Item 3'}]}}});

然后，在我们的组件中（例如src/components/ItemList.vue），我们可以使用computed属性来获取数据并进行绑定：

<template> <div> <ul> <li v-for="item in itemList" :key="item.id"> <h2>{{ item.name }}</h2> <p>{{ item.description }}</p> </li> </ul> </div> </template> <script> import { dataStore } from '@/store/dataStore.js'; export default { name: 'ItemList', computed: { itemList() { return dataStore.itemList; } } } </script> <style scoped> .item-list { margin-top: 20px; } .item-list ul { list-style-type: none; padding: 0; } .item-list li { border-bottom: 1px solid #ccc; padding: 10px 0; } </style>

当dataStore中的itemList数据发生变化时，组件会自动更新显示。

六、事件处理

在 Vue 组件中，我们还可以处理各种用户事件。例如，我们为ItemList组件中的每个项目添加一个点击事件，当点击项目时弹出一个提示框显示项目的详细信息。修改ItemList.vue组件的代码如下：

<template> <div> <ul> <li v-for="item in itemList" :key="item.id" @click="showItemDetails(item)"> <h2>{{ item.name }}</h2> <p>{{ item.description }}</p> </li> </ul> </div> </template> <script> import { dataStore } from '@/store/dataStore.js'; export default { name: 'ItemList', computed: { itemList() { return dataStore.itemList; } }, methods: { showItemDetails(item) { alert(`Item ID: ${item.id}\nName: ${item.name}\nDescription: ${item.description}`); } } } </script> <style scoped> .item-list { margin-top: 20px; } .item-list ul { list-style-type: none; padding: 0; } .item-list li { border-bottom: 1px solid #ccc; padding: 10px 0; } </style>

通过@click指令绑定showItemDetails方法，当用户点击项目时，就会触发该方法并弹出提示框。

七、总结

通过 Microi 吾码低代码框架与 Vue 的结合，我们能够在应用开发中实现高效的开发流程。从项目初始化到创建 Vue 组件，再到数据交互、绑定和事件处理，每一个环节都展示了这种组合的强大之处。这种方式不仅提高了开发效率，还使得应用具有更好的可维护性和用户体验。在实际项目开发中，开发者可以根据具体需求进一步拓展和优化应用，充分发挥 Microi 吾码低代码框架和 Vue 的优势，构建出更加复杂和功能强大的高效应用。