二、uni-app入口文件(main.js)

一、概述

main.js 是整个 uni-app 应用的入口文件。当你的微信小程序启动时,系统第一个找的就是这个文件。

主要任务:创建一个 Vue 应用实例,把 App.vue 挂载起来,然后告诉框架:"准备好啦,可以开始运行整个应用了!"。

二、作用

1. 初始化 Vue 实例

这是它最核心的工作。它会把你的根组件 App.vue 引进来,创建一个 Vue 应用实例,并把它交给 uni-app 框架去渲染。

2. 安装全局插件

在开发中,我们经常会用到一些状态管理工具(比如 Pinia 或 Vuex),你可以把它们理解为"全局仓库"。在 main.js 里,你可以把这个仓库注册到整个应用中,这样你在任何一个页面都能轻松存取数据。

3. 注册全局组件

假设你写了一个非常好看的"自定义按钮"组件,几乎每个页面都要用。如果你在每个页面都去 import 引入一次,会非常麻烦。你可以在 main.js 中把它注册为全局组件,之后在任何页面都可以直接使用,不用再重复引入。

4. 挂载全局属性

比如你封装了一个网络请求方法 request.js,希望在所有页面都能通过 this.$api 直接调用。你就可以在 main.js 中把它挂载到全局属性上,实现"一次配置,处处使用"。

三、示例

下面是一份完整的 main.js 最佳实践示例(Vue3):

js 复制代码
// main.js - uni-app 最佳实践示例 (Vue3)

// 1. 引入核心依赖
import App from './App.vue'
import { createSSRApp } from 'vue' // uni-app 官方推荐使用 createSSRApp 以兼容多端和 SSR
import { createPinia } from 'pinia' // 引入 Pinia 状态管理插件
import MyButton from '@/components/MyButton.vue' // 引入自定义全局组件

// 2. 引入自定义封装的全局工具(例如网络请求工具)
import { $http } from '@/utils/request'

// 3. 创建应用实例的入口函数(uni-app 约定的写法)
export function createApp() {
  const app = createSSRApp(App) // 使用 App.vue 作为根组件创建实例

  // === 核心配置区 ===

  // ① 安装全局插件(如 Pinia 状态管理)
  const pinia = createPinia()
  app.use(pinia)

  // ② 注册全局组件(任何页面都可以直接使用 <MyButton />)
  app.component('MyButton', MyButton)

  // ③ 挂载全局属性(把网络请求挂载到全局,页面中可通过 this.$http 调用)
  app.config.globalProperties.$http = $http

  // 返回应用实例,交由 uni-app 框架接管后续的生命周期和渲染
  return {
    app
  }
}
相关推荐
界面开发小八哥1 小时前
界面控件DevExpress Blazor v26.1新版亮点 - TreeList & 数据编辑器
javascript·编辑器·.net·界面控件·blazor·devexpress·用户界面
mCell10 小时前
Lua 编程入门:从基础语法到元表
javascript·算法·lua
伟大的兔神10 小时前
我做了一个本地优先的 AI 图片工作台:Loomora v1.0.0 正式发布
前端·javascript·vue.js
fangzhanpeng16813 小时前
(前端)2.js变量作用域样例
开发语言·前端·javascript
码艺-Alimjan15 小时前
Vue项目源码备份最佳实践:无视node_modules,打包体积仅2MB
前端·javascript·vue.js
xixiaoyunya17 小时前
JavaScript 异步编程全解析:从回调地狱到 async/await 的演进之路
开发语言·javascript·ecmascript
张元清17 小时前
React useScrollLock Hook:为弹窗锁住页面滚动 (2026)
javascript·react.js
Sayai17 小时前
【无标题】ECharts 实现日志量异常检测:基线 ±Kσ 基带 + 灵敏度切换(Vue2 实战)
前端·javascript·echarts
默_笙18 小时前
💌 为了把"主题色"传给孙子组件,我翻了五层楼——直到遇见了 useContext
前端·javascript