使用vscode开发小程序项目

小夏同学呀2024-01-09 16:02

使用vscode开发uni-app

这里的创建使用用vue3+ts版本，如过是vue2，具体可参考官网命令
uni-app官网

首先创建uni-app

javascript 复制代码

`npx degit dcloudio/uni-preset-vue#vite-ts my-vue3-project`

需要再vscode中下载uni-app插件，以方便开发

uni-create-view 快速常见uni-app页面
uni-helper uni-app代码提示
uniapp小程序扩展鼠标悬停查看文档

安装ts声明校验

安装 类型声明文件

javascript 复制代码

`pnpm i -D miniprogram-api-typings @uni-helper/uni-app-types`

配置 tsconfig.json

javascript 复制代码

{
  "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"], // [!code ++]
    "experimentalRuntimeMode": "runtime-uni-app" // [!code --]
  },
  "include": ["src/**/*.ts", "src/**/*.d.ts", "src/**/*.tsx", "src/**/*.vue"]
}

工作区设置参考

javascript 复制代码

// .vscode/settings.json
{
  // 在保存时格式化文件
  "editor.formatOnSave": true,
  // 文件格式化配置
  "[json]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },
  // 配置语言的文件关联
  "files.associations": {
    "pages.json": "jsonc", // pages.json 可以写注释
    "manifest.json": "jsonc" // manifest.json 可以写注释
  }
}

JSON 注释问题

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

danger 版本升级 ,在ts.config.json中的types中进行添加

javascript 复制代码

- 原依赖 `@types/wechat-miniprogram` 现调整为 `miniprogram-api-typings`
- 原配置 `experimentalRuntimeMode` 现调整为 `nativeTags`。

这一步处理很关键，否则 TS 项目无法校验组件属性类型。