uni-app基础

命令行创建 uni-app 项目

优势

通过命令行创建 uni-app 项目，不必依赖 HBuilderX，TypeScript 类型支持友好。

# 通过 npx 从 github 下载

npx degit dcloudio/uni-preset-vue#vite-ts 项目名称

用 VS Code 开发 uni-app 项目

为什么选择 VS Code？

VS Code 对 TS 类型支持友好，前端开发者主流的编辑器

HbuilderX 对 TS 类型支持暂不完善，期待官方完善 

注意事项

没开发过 Vue3 + TS 项目的小伙伴注意，需要先安装 Vue3 和 TS 的插件，并完成以下配置 👇

安装 Vue Language Features (Volar) ：Vue3 语法提示插件

安装 TypeScript Vue Plugin (Volar) ：Vue3 的 TS 插件

工作区禁用 Vetur 插件(Vue2 插件和 Vue3 插件冲突)

工作区禁用 @builtin typescript 插件（禁用后自动开启 Vue3 的 TS 托管模式）

安装 uni-app 插件

👉 安装 uni-app 开发插件

uni-create-view ：快速创建 uni-app 页面

uni-helper ：uni-app 代码提示

uniapp 小程序扩展 ：鼠标悬停查文档

👉 TS 类型校验

安装 类型声明文件 pnpm i -D miniprogram-api-typings @uni-helper/uni-app-types

配置 tsconfig.json

👉 JSON 注释问题

设置文件关联，把 manifest.json 和 pages.json 设置为 jsonc

tsconfig.json 参考

// tsconfig.json

{

  "extends": "@vue/tsconfig/tsconfig.json",

  "compilerOptions": {

    "sourceMap": true,

    "baseUrl": ".",

    "paths": {

      "@/*": ["./src/*"]

    },

    "lib": ["esnext", "dom"],

    // 类型声明文件

    "types": [

      "@dcloudio/types", // uni-app API 类型

      "miniprogram-api-typings", // 原生微信小程序类型

      "@uni-helper/uni-app-types" // uni-app 组件类型

    ]

  },

  // vue 编译器类型，校验标签类型

  "vueCompilerOptions": {

    // 原配置 `experimentalRuntimeMode` 现调整为 `nativeTags`

    "nativeTags": ["block", "component", "template", "slot"],

  },

  "include": ["src/**/*.ts", "src/**/*.d.ts", "src/**/*.tsx", "src/**/*.vue"]

}