【uni-app】用 VS Code 开发 uni-app 项目

用 VS Code 开发 uni-app 项目

在这里插入图片描述

为什么选择 VS Code?

  • VS Code 对 TS 类型支持友好,前端开发者主流的编辑器
  • HbuilderX 对 TS 类型支持暂不完善,期待官方完善 👀
    在这里插入图片描述

用 VS Code 开发配置

项目采用 Vue3 + TS 开发 uni-app 项目,所以需要分别安装 Vue3 + TS 插件 和 uni-app 插件。

首先,打开项目
  • 在项目代码,点击鼠标右键,选择通过Code打开
    在这里插入图片描述
安装 Vue3 + TS 插件

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

需禁用的插件此处注意

在这里插入图片描述

安装 uni-app 插件
  • 👉 安装 uni-app 开发插件
  • 👉 TS 类型校验
    • 安装 类型声明文件 pnpm i -D miniprogram-api-typings @uni-helper/uni-app-types
    • 配置 tsconfig.json
  • 👉 JSON 注释问题
    • 设置文件关联,把 manifest.jsonpages.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"]
}

工作区设置参考

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

在这里插入图片描述

版本升级

  • 原依赖 @types/wechat-miniprogram 现调整为 miniprogram-api-typings
  • 原配置 experimentalRuntimeMode 现调整为 nativeTags
  • 不允许属性nativeTags–解决办法
    在这里插入图片描述

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

### 使用 VSCode 进行 UniApp 开发配置 #### 安装必要的扩展 为了使 VSCode 支持 UniApp开发,安装特定的扩展是必不可少的一部分。这些扩展提供了诸如语法高亮、代码片段支持以及智能感知等功能[^2]。 对于增强编辑器的功能并提供更好的编码体验而言,推荐安装如下几个插件: - **Vetur**: 提供 Vue 文件的支持,包括语法高亮、Emmet 缩写展开等特性。 - **Uni-app Helper**: 专为 UniApp 设计的帮助工具,能够提升工作效率。 - **Path Intellisense**: 自动补全路径名,提高文件引入效率。 #### 设置 `launch.json` 调试配置 为了让开发者能够在 VSCode 中顺利运行和调试程序,设置合适的启动配置至关重要。创建 `.vscode/launch.json` 文件来定义调试选项,这使得可以在不离开 IDE 的情况下轻松测试应用[^3]。 ```json { "version": "0.2.0", "configurations": [ { "name": "Launch Chrome against localhost", "type": "chrome", "request": "launch", "url": "http://localhost:8080", "webRoot": "${workspaceFolder}" } ] } ``` 此配置允许通过连接到本地服务器实例来进行实时预览和调试工作。 #### 配置语言关联规则 合理调整文件类型的识别有助于获得更精准的服务和支持。可以通过修改项目的根目录下的 `.vscode/settings.json` 来指定某些特殊文件应被当作哪种编程语言处理[^4]: ```json // 配置语言的文件关联 "files.associations": { "*.vue": "vue", "pages.json": "jsonc", "manifest.json": "jsonc" }, ``` 上述设定确保了像 `pages.json` 和 `manifest.json` 这样的配置文件能享受到 JSON with Comments (JSONC) 所带来的便利之处——即保留注释的能力。 ---
评论 2
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值