原生 Vue + UniApp 的小程序或 App 项目里如何判断用户是否为首次下载应用

一：本地存储标记法（常用）

核心思路：
用 uni.setStorageSync 存一个布尔值标志，判断是否第一次进入。

Vue2 写法

// App.vue
export default {
  onLaunch() {
    const firstEnter = uni.getStorageSync('firstEnter')
    if (!firstEnter) {
      console.log(' 首次进入应用')
      uni.setStorageSync('firstEnter', true)
      // 比如跳转到引导页
      uni.reLaunch({ url: '/pages/guide/guide' })
    } else {
      console.log(' 已经进入过')
    }
  }
}

Vue3 写法

// App.vue
import { onLaunch } from '@dcloudio/uni-app'

export default {
  setup() {
    onLaunch(() => {
      const hasEntered = uni.getStorageSync('hasEntered')
      if (!hasEntered) {
        console.log(' 首次进入')
        uni.setStorageSync('hasEntered', true)
        uni.reLaunch({ url: '/pages/guide/guide' })
      } else {
        console.log(' 非首次进入')
      }
    })
  }
}

优点：

• 实现简单、逻辑清晰；
• 无需网络请求；
• 通用于小程序、App、H5。

缺点：

• 卸载或清除缓存后会重新判断为“首次进入”；
• 无法区分同一账号在不同设备的首次进入（仅限本设备）。

适用场景：
大部分项目的启动引导页、功能介绍页。

二：App 端文件标记（数据在设备中能保存更久，不容易被清除或覆盖。）

核心思路：
通过 plus.io（仅 App 端可用）在本地文件系统中保存标志文件，能防止被清除缓存影响。

vue2写法

// App.vue
export default {
  onLaunch() {
    // 仅在 App 端有效
    #ifdef APP-PLUS
    console.log('App 启动，检测是否首次进入...')
    plus.io.resolveLocalFileSystemURL('_doc/', (entry) => {
      // 尝试获取 firstEnter.txt 文件（create:false 表示不自动创建）
      entry.getFile(
        'firstEnter.txt',
        { create: false },
        (fileEntry) => {
          // 文件存在 → 非首次进入
          console.log(' 已存在文件 -> 非首次进入')
          // 你可以在这里执行“老用户逻辑”
        },
        (error) => {
          // 文件不存在 → 首次进入
          console.log(' 文件不存在 -> 首次进入')
          // 创建文件以记录状态
          entry.getFile('firstEnter.txt', { create: true }, (newFile) => {
            console.log(' 已创建标记文件，记录首次进入')
            // 执行首次进入逻辑，比如引导页
            uni.reLaunch({ url: '/pages/guide/guide' })
          })
        }
      )
    }, (err) => {
      console.error(' resolveLocalFileSystemURL 解析失败:', err)
    })
    #endif
  }
}

vue3写法

// App.vue
import { onLaunch } from '@dcloudio/uni-app'

export default {
  setup() {
    onLaunch(() => {
      // 仅在 App 端有效
      #ifdef APP-PLUS
      console.log('App 启动，检测是否首次进入...')
      plus.io.resolveLocalFileSystemURL(
        '_doc/',
        (entry) => {
          entry.getFile(
            'firstEnter.txt',
            { create: false },
            (fileEntry) => {
              console.log(' 已存在文件 -> 非首次进入')
              // 老用户逻辑放这里
            },
            (error) => {
              console.log(' 文件不存在 -> 首次进入')
              entry.getFile('firstEnter.txt', { create: true }, (newFile) => {
                console.log(' 已创建标记文件，记录首次进入')
                // 首次进入逻辑，例如跳转引导页
                uni.reLaunch({ url: '/pages/guide/guide' })
              })
            }
          )
        },
        (err) => {
          console.error(' resolveLocalFileSystemURL 解析失败:', err)
        }
      )
      #endif
    })
  }
}

注释

• _doc/ 是 App 本地的持久化文件目录；
• resolveLocalFileSystemURL 是解析逻辑路径的入口；
• entry 是文件或目录对象，可以用来创建、读取、删除文件；
• 这些都是 HTML5+ (plus.io) 提供的 API，仅在 App 端（APP-PLUS） 可用

常见路径

_doc/ 是什么？

plus.io.resolveLocalFileSystemURL() 是什么？

entry 是什么？

优点：

• 即使清除缓存，文件仍在；
• 适合需要长期判断首次进入的 App。
  缺点：
• 仅适用于 App，不支持小程序；
• 代码稍复杂；
• 不适合纯前端（H5）运行。

适用场景：
需要高持久性首次检测（比如 App 引导页、注册流程控制）。

三：基于用户账号（后端标记）

核心思路：
当用户登录后，通过服务器接口判断该用户是否第一次使用该账号登录

// login.vue
uni.login({
  success: async (res) => {
    const userInfo = await uni.request({
      url: 'https://api.xxx.com/checkFirstEnter',
      method: 'POST',
      data: { userId: res.userInfo.id }
    })
    if (userInfo.data.isFirstEnter) {
      console.log(' 该账号首次登录')
    } else {
      console.log(' 老用户')
    }
  }
})

优点：

• 跨设备一致；
• 适合有账号体系的应用；
• 可统计新用户注册、留存。

缺点：

• 依赖网络；
• 需要后端配合；
• 无法在未登录状态下判断。

适用场景：
需要区分新老用户的业务场景（如营销活动、统计分析）。