vscode中需在keybindings.json中自定义快捷键绑定npx cap sync、npx cap open android、npx cap run android三类高频命令；其余如cap add仅需执行一次，cap build易出错不推荐绑定。
VSCode里怎么用快捷键触发Capacitor关键命令
VSCode本身不内置Capacitor命令绑定，所有npx cap操作都得手动敲——但你可以把高频命令映射成快捷键，省掉重复输入。重点不是“有没有快捷键”，而是“哪些命令值得绑定”。
推荐绑定的三个命令（在keybindings.json中配置）：
-
npx cap sync：每次改完前端代码后必须执行，否则原生工程里还是旧HTML/JS -
npx cap open android：快速跳转到Android Studio，比手动找android/目录快得多 -
npx cap run android：真机一键部署（需提前连好设备、开USB调试）
注意：npx cap add android只用一次，没必要绑快捷键；npx cap build不推荐直接用，它只生成APK但不校验签名，容易出错。
真机联调时断点不生效？先查launch.json配对没
断点变灰、变量面板空、this指向丢失——90%是launch.json里"type"写错了。Capacitor调试走的是专用代理，不是Chrome DevTools协议。
必须确认以下三项：
-
"type": "capacitor"（不是chrome、node或cppdbg） -
"url": "http://localhost:3000"（不能是file://，否则WebView直接拒载） -
"webRoot": "${workspaceFolder}/dist"（Vite默认路径；UniApp是${workspaceFolder}/dist；SvelteKit可能是${workspaceFolder}/build/client）
漏掉任一栏，VSCode就当源码不存在，断点自然失效。
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话 。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本 。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
Android真机调试前必须开两个开关
光连USB、装APK还不够。Android WebView调试是独立开关，系统默认关闭。
手机上要手动打开：
- 设置 → 关于手机 → 连点7次“版本号”启用开发者选项
- 设置 → 开发者选项 → 启用“USB调试”
- 设置 → 开发者选项 → 启用“WebView调试”（名称可能叫“Enable WebView debugging”或“Debug WebViews”）
缺最后一个，VSCode能连上设备、能看到进程，但断点完全不响应——因为WebView根本没暴露调试接口。
打包APK别在VSCode里点菜单，终端顺序不能乱
VSCode没有“Build APK”按钮，所谓“打包”其实是串行调用命令。顺序错一步，Android Studio里就报No usable Android build tools found或Failed to find Build Tools revision。
正确流程（全部在VSCode集成终端执行）：
-
npx cap sync android（同步前端资源到原生工程） -
npx cap open android（用Android Studio打开，别手动双击） - 等AS加载完Gradle，再在AS里点
Build > Build Bundle(s) / APK(s) > Build APK(s)
别在VSCode里用ionic cordova build android混用Cordova命令——Capacitor和Cordova的插件、配置、SDK路径全不兼容，会直接污染项目。
npx cap sync和WebView调试开关这两步。前者决定代码是否真进了APK，后者决定VSCode能不能触达WebView内部——中间任何一环断了，调试就变成盲调。
