从VSCode执行npx cap open android启动Android Studio失败求助

问题定位 #

既不是VSCode也不是Android Studio的功能故障——npx cap run android能正常运行说明Android构建工具链和Studio的核心功能都正常，问题出在Capacitor CLI无法正确识别Android Studio的启动路径（cap open需要调用IDE可执行文件，而cap run仅调用构建命令，无需启动IDE）。

具体解决方案 #

• 配置系统环境变量
  确保系统中存在指向Android Studio安装目录的环境变量：

  • Windows：新增/编辑ANDROID_STUDIO变量，值为Android Studio的安装路径（例如C:\Program Files\Android\Android Studio），或者直接指向启动exe：C:\Program Files\Android\Android Studio\bin\studio64.exe
  • Mac/Linux：在终端配置文件（~/.bash_profile/~/.zshrc）中添加：

    export ANDROID_STUDIO="/Applications/Android Studio.app"
    

    执行source ~/.zshrc（对应你的shell类型）使配置生效

• 在Capacitor配置中手动指定IDE路径
  编辑项目根目录的capacitor.config.ts（或capacitor.config.json），添加Android IDE的路径配置：

  import { CapacitorConfig } from '@capacitor/cli';
  
  const config: CapacitorConfig = {
    appId: 'com.your.app.id',
    appName: 'YourAppName',
    webDir: 'www',
    bundledWebRuntime: false,
    android: {
      // Windows示例路径，注意转义反斜杠
      // ide: "C:\\Program Files\\Android\\Android Studio\\bin\\studio64.exe"
      // Mac示例路径
      ide: "/Applications/Android Studio.app"
    }
  };
  
  export default config;
  

  保存后重新执行npx cap open android

• 更新Capacitor CLI到最新稳定版
  旧版本CLI可能存在路径识别bug，执行以下命令更新：

  npm install @capacitor/cli@latest @capacitor/core@latest
  

• 验证Android Studio本身的可启动性
  直接手动启动Android Studio（双击exe/点击图标），确认能正常打开，排除软件损坏或启动故障的可能

内容的提问来源于stack exchange，提问作者Tor Bloodaxe