cordova在vscode中无法直接运行，必须先全局安装cordova cli（npm install -g cordova）并配置好node、jdk、android sdk等命令行环境；插件仅提供调试连接和语法提示，不承担构建功能。
Cordova在VSCode里不能直接跑起来，必须先配好命令行环境，编辑器只是个“高级记事本”+调试界面。
node + cordova CLI 是硬性前置条件
VSCode本身不提供Cordova构建能力，所有cordova platform add、cordova build、cordova run都依赖全局安装的CLI。没装好这个，插件再 fancy 也白搭。
- 必须用
npm install -g cordova安装（注意：不是项目内局部安装） - 验证是否生效：终端执行
cordova --version，有输出才说明CLI就位 - 如果报
command not found: cordova，大概率是npm全局bin路径没进系统PATH——查npm config get prefix，把bin目录手动加到环境变量里 - 别跳过JDK和Android SDK：
cordova run android失败90%卡在这俩，尤其ANDROID_HOME和ANDROID_SDK_ROOT必须同时设对，且指向同一SDK根目录
Cordova Tools插件只负责“连接”和“提示”，不负责“编译”
微软官方的Cordova Tools扩展（ID：msjsdiag.cordova-tools）本质是个桥接器：它把VSCode的调试器连到Chrome DevTools或原生设备上，同时给config.xml、plugin.xml加语法提示。但它不会帮你下载Android SDK、不会自动接受license、也不会替你跑sdkmanager。
- 装完插件后，按
Ctrl+Shift+P（Win）或Cmd+Shift+P（Mac），搜Cordova能看到一堆命令，比如Cordova: Run on device——这些命令底层仍是调用CLI，所以前面的环境必须已通 -
config.xml里写错widget id或content src路径，插件会标红，但不会自动修正；它只校验XML结构，不校验逻辑有效性 - 真机调试时，插件依赖
adb可用。如果adb devices看不到设备，插件里的Run on device按钮就是灰色的，不会给你任何解释
平台添加失败常见于三个隐藏坑点
cordova platform add android看起来就一行命令，实际背后要拉取Gradle、Android Gradle Plugin、SDK Platform、Build Tools四层东西，任一环节断链都会静默失败或报错模糊。
- Gradle版本不匹配：Cordova 12+默认要求Gradle 7.5+，但旧项目
platforms/android/gradle/wrapper/gradle-wrapper.properties里写的还是6.5——手动改distributionUrl，再删掉platforms/android/.gradle缓存重试 - Android SDK license没接受：
cordova build android卡在Checking the license for package...？必须进SDK目录运行sdkmanager --licenses，逐条输y，不能跳过 - Windows下路径含空格或中文：哪怕项目名是
my app或测试项目，platform add大概率中途崩溃，错误信息里甚至不提原因——一律用纯英文、无空格路径
调试时别指望“一键启动模拟器”
VSCode的Cordova插件不管理AVD（Android Virtual Device）。它只做两件事：检测已运行的模拟器/设备，然后把app推过去并attach debugger。没有模拟器，它不会帮你创建、启动、等待就绪。
- 想用模拟器，得提前用
avdmanager或Android Studio建好AVD，再用emulator -avd <name></name>手动启动 - 用逍遥模拟器、夜神这类第三方模拟器？确保
adb connect 127.0.0.1:21503能连上，且adb devices列表里出现127.0.0.1:21503这一行 - 真机调试前，务必打开开发者选项 + USB调试，并在弹出授权框时点“允许”——插件不会提示你这一步，它只等
adb返回设备列表
最常被忽略的是：Cordova项目里www目录是源码出口，但VSCode里编辑的Vue/React代码默认不在那儿。你得自己把构建产物（比如npm run build生成的dist）拷进www，或者用cordova serve配合browser平台预览——否则改了JS，cordova run android出来的还是旧页面。
