uni-app怎么集成TypeScript-uni-app-PHP中文网

必须手动确认 Use TypeScript? 为 Yes，否则生成非完整TS项目；需检查 tsconfig.json 和 src/main.ts 是否存在，并在 compilerOptions.types 中添加 "@dcloudio/types"。

uni-app怎么集成typescript

直接用 npm create uni-app@latest 创建项目时，必须手动确认 Use TypeScript? 为 Yes，否则生成的是 main.js 和空的 TS 支持——这不是你手速慢，是 CLI 最后一步默认高亮 No，回车就跳过。

很多人以为选了 “TypeScript” 模板就完事了，其实 create uni-app@latest 的交互分两步：先选模板，再单独确认是否启用 TS。终端里看到 Use TypeScript? » No 时，得用方向键切换到 Yes 再回车。

创建完立刻检查根目录：必须同时存在 tsconfig.json 和 src/main.ts；缺任何一个，说明失败，删掉重来
别试图在 JS 项目里后期加 TS——@dcloudio/types 类型声明、defineApp / definePage 泛型适配、pages.json 类型导入等一整套链路会断裂
禁用旧版全局安装的 @vue/cli-plugin-uni 或第三方脚手架，它们不认官方 TS 编译逻辑

即使生成了 tsconfig.json，默认配置也不含 uni 全局 API 类型，uni.showToast、getCurrentPages() 会报 Cannot find name 'uni' 或推导为 any。

在 compilerOptions.types 中加入 "@dcloudio/types"（HBuilderX 官方维护）和可选的 "@uni-helper/uni-app-types"（补全方法签名）
include 至少覆盖 "src/**/*" 和 "types/**/*"（如有自定义声明文件）
避免设 target: "es5"——uni-app 编译器实际依赖 es6+ 语法，设低了反而触发兼容性降级错误

<script lang="ts"></script> 只是告诉编译器走 TS 流程，但 Vue 3 + Composition API 下，类型推导失效很常见。

你是 TypeScript 项目架构专家，专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链（pnpm、Vite、Next.js）、类型

下载

页面组件（如 pages/index/index.vue）必须用 definePage() 包裹，不能用 defineComponent()；且推荐显式泛型，例如 definePage()
App.vue 必须用 defineApp，setup 返回值需与 data 类型一致，否则 this.$scope 等属性无类型提示
getCurrentPages() 返回值默认是 any[]，必须手动断言：getCurrentPages() as Page.PageInstance[]（H5）或按平台选 WechatMiniprogram.Page.Instance 等

虽然 pages.json 是 JSON 文件，但你在 TS 里 import pages from '@/pages.json' 时，TS 默认不识别它的结构，报 Cannot find module 或推导为 any。

在 src/types/global.d.ts 中添加：declare module '@/pages.json' { const value: PagesJson; export default value; }
再定义 interface PagesJson，字段按实际需要写（如 path: string、style: Record），别直接用 any
不同平台对 subNVue、usingComponents 等字段支持不一，硬编码比放任 any 更可控