VSCode需安装uni-create-view（右键建页并自动注册路由）、uni-helper（提供uni.*API及组件类型提示）及Vue-Official插件，并配置tsconfig.json引入@dcloudio/types和@uni-helper/uni-app-types，同时将manifest.json和pages.json文件关联设为jsonc以支持注释。

VSCode 能完整支撑 uni-app 开发，但开箱即用的体验几乎为零——不装对插件、不改配置，连 uni.showToast 的参数都看不到提示，pages.json 里加个 // 注释 就红波浪线报错。

uni-create-view 插件必须装，页面注册不能手动写

右键 pages 目录新建页面时，如果没装 uni-create-view，就只能手敲路径、手改 pages.json，极易漏配或格式出错。它不是“锦上添花”，而是解决最频繁操作的刚需：

• 安装后默认建单文件（如 pages/my/my.vue），但主流项目结构是文件夹形式（pages/my/index.vue）——需进插件设置勾选「创建同名文件夹」
• 自动在 pages.json 的 "pages" 数组末尾插入新路由，路径和样式字段都按规范生成
• 不依赖 HBuilderX 或 CLI 命令，纯 VSCode 内操作，适合已习惯快捷键和右键菜单的团队

uni-helper + 类型包缺一不可，否则 TS 形同虚设

哪怕项目是 Vue 3 + TypeScript 模板，uni.getSystemInfoSync() 返回值默认仍是 any。类型提示不是自动来的，得手动接上两层：

• 装两个 dev 依赖：pnpm add -D @uni-helper/uni-app-types @dcloudio/types（注意不是 @types/wechat-miniprogram，那个只覆盖小程序端，不覆盖 uni.* 全局 API）
• 修改 tsconfig.json 的 compilerOptions.types，确保包含 ["@dcloudio/types", "@uni-helper/uni-app-types"]
• Vite 模板还需确认 vueCompilerOptions.nativeTags 包含 "component" 和 "slot"，否则自定义组件标签（如 ）会标红

manifest.json 和 pages.json 必须设为 jsonc

这两个文件官方明确允许写 // 注释，但 VSCode 默认按严格 JSON 解析，一加注释就报错。这不是代码问题，是编辑器识别错误：

Scrapfly SDK TypeScript

使用 Scrapfly SDK（scrapfly-sdk）在 TypeScript 或 JavaScript 中进行网页抓取，用于用户请求抓取 URL、绕过反爬虫防护、渲染页面等场景。

下载

• 打开 VSCode 设置（Ctrl+, ），搜 files.associations
• 添加两条规则："manifest.json": "jsonc" 和 "pages.json": "jsonc"
• 保存后重启窗口，已有注释立即生效，无需删内容、改后缀、动构建流程
• 其他 JSON 文件（如 package.json）不能随便设为 jsonc，只有这两个文件被 uni-app 构建工具特许支持注释

别硬记运行命令，package.json 里配好脚本最稳

不同平台编译命令差异大：pnpm run dev:mp-weixin、pnpm run build:h5、pnpm run build:app-plus……手敲易错，且 CI/CD 流水线也依赖统一入口：

• 在 package.json 的 scripts 里明确定义常用命令，例如："dev:wx": "uni-dev -p mp-weixin"
• 避免直接调用底层 CLI（如 uni-dev），优先用项目内封装好的脚本，它们已适配当前模板版本
• 如果用的是 Vite 模板，确认 uni-app-vite-plugins 已正确注册，否则 dev:mp-weixin 可能启动失败但无明确报错

最容易被忽略的是类型包与 tsconfig.json 的联动——装了 @uni-helper/uni-app-types 却忘了加进 types 数组，VSCode 就当它不存在；改了 files.associations 却没重启窗口，注释还是红的。这些都不是“试试看”的小问题，而是阻断开发流的硬性门槛。