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。类型提示不是自动来的，得手动接上两层：
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话 。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本 。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
- 装两个 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"，否则自定义组件标签（如<uni-button></uni-button>）会标红
manifest.json 和 pages.json 必须设为 jsonc
这两个文件官方明确允许写 // 注释，但 VSCode 默认按严格 JSON 解析，一加注释就报错。这不是代码问题，是编辑器识别错误：
- 打开 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 却没重启窗口，注释还是红的。这些都不是“试试看”的小问题，而是阻断开发流的硬性门槛。
