vscode本身不提供taro语法检查，校验依赖typescript编译器和taro cli；taro允许react/vue混合写法但不报错，因ts仅解析jsx、忽略vue指令，真正错误在taro build阶段暴露。
VSCode 本身不提供 Taro 跨端语法检查能力，真正的语法校验来自 TypeScript 编译器（tsc）和 Taro CLI 的编译时校验；VSCode 只是把 tsconfig.json 和 config/index.ts 配置读进去，再调用语言服务呈现错误提示。
为什么改了 Vue/React 混合写法没报错
Taro 允许在同一个项目中混用 React 和 Vue 语法（比如用 React.createElement 写逻辑，但模板里写 <view></view>），但这不等于语法无约束。VSCode 不会主动拦截这种“合法但跨框架”的写法，因为：
- Taro 的组件标签（
<view></view>、<text></text>）本质是 JSX/TSX 中的合法标识符，TypeScript 默认不校验组件是否属于当前框架生态 - Vue 模板语法（如
v-if）在 .tsx 文件里会被直接忽略——TS 解析器只认 JSX，不认 Vue 指令 - 真正报错要等到
taro build阶段：比如你在 React 项目里写了<template></template>标签，webpack 插件才会抛出Unknown tag <template></template>
如何让 VSCode 显示 Taro 特有语法错误
关键不是装插件，而是确保 TS 语言服务能加载 Taro 类型定义。常见失效场景和修复方式：
- 没装
@tarojs/taro类型包：运行yarn add -D @types/react @tarojs/taro（React 项目）或yarn add -D @tarojs/taro @tarojs/components（Vue 项目） -
tsconfig.json的include没覆盖src/**/*：删掉files字段，只留include+exclude - VSCode 打开的不是项目根目录：必须用 VSCode 直接打开含
tsconfig.json和config/index.ts的文件夹，否则 TS Server 不启动 - 用了
/// <reference types="..."></reference>但路径错：Taro v3.6+ 推荐用compilerOptions.types声明，例如：{"compilerOptions": {"types": ["@tarojs/taro"]}}
taro build --watch 时热更新不触发的路径陷阱
VSCode 保存文件后，taro build --type weapp --watch 没反应，90% 是监听路径没对上。典型表现：
- 你在 VSCode 里右键「在终端中打开」，结果终端当前路径是
./src/pages/index/，而非项目根目录 - 执行
taro build --type weapp --watch后，日志显示Watching: src/**/*，但你改的是./app.config.ts—— 它不在src/下 - VSCode 设置了
files.autoSave为onFocusChange，但你切窗口太快，文件其实没真正落盘，chokidar拿不到change事件
验证方法：在终端手动执行 node -e "console.log(require('fs').realPathSync('.'))"，看输出是否等于项目根路径。
多端编译配置别硬套 template
Taro 的 config/index.ts 不是静态模板，不同端（weapp、h5、rn）需要差异化配置，但很多人直接复制粘贴导致：
- H5 端开启
enableExtractStyles: true，但微信小程序不支持 CSS in JS 提取，编译时报Cannot resolve 'style' in ... - RN 端用了
miniCssExtractPlugin，但 React Native 不走 webpack，直接 crash - 在
weapp配置里写了alias指向react-native包，导致小程序编译时去 node_modules 里找 RN 组件，报Module not found: Error: Can't resolve 'react-native'
正确做法是用环境变量分条件导出：
export default function (merge) { return merge({}, { h5: { enableExtractStyles: true }, weapp: { enableExtractStyles: false } })}而不是在一个对象里堆所有平台配置。
最常被忽略的一点：Taro 的类型检查和热更新依赖两个独立进程——tsc --watch 负责 TS 语法，taro build --watch 负责文件变化和编译。它们不共享状态，所以改了 tsconfig.json 后，必须重启 VSCode 的 TS Server（Ctrl+Shift+P → “TypeScript: Restart TS server”），否则新规则不会生效。
