vscode 开发Android

下面这份清单专为零基础、纯新手整理，全部是“装完就能用”的 VSCode 插件，直接照着装即可，不用纠结。

---

一、必装核心（不装写不了 Android）

1. Extension Pack for Java（微软官方）

• 包含：Java 语法、补全、格式化、调试、测试、Maven/Gradle 支持
• 作用：Java 开发基础，Android 必装
• 搜索名：Extension Pack for Java

2. Kotlin Language（JetBrains 官方）

• 作用：Kotlin 语法高亮、智能提示、格式化、跳转定义
• 新手提示：现在 Android 主流是 Kotlin，必装
• 搜索名：Kotlin Language

3. Android Tools for VS Code（强烈推荐）

• 功能：
  • 一键启动模拟器/连接真机
  • 查看 Logcat（日志）
  • 直接 Run/Debug 应用
  • 安装 APK、XML 预览
• 作用：把 Android Studio 常用功能搬到 VSCode
• 搜索名：Android Tools for VS Code

4. Gradle Language Support

• 作用：build.gradle语法高亮、补全、错误提示
• 新手提示：Android 项目靠 Gradle 构建，必须装
• 搜索名：Gradle Language Support

5. XML Tools

• 作用：格式化 XML（布局、Manifest）、标签闭合、验证
• 新手痛点：Android 大量 XML，没插件很难受
• 搜索名：XML Tools

---

二、调试 & 运行（直接在 VSCode 跑 App）

6. Debugger for Java（已包含在 Java Pack）

• 作用：断点调试、变量查看、调用栈
• 新手提示：不用单独装，装了第1条就有

7. Code Runner（可选但推荐）

• 作用：右键直接运行 Java/Kotlin 单个文件
• 新手场景：写个小工具类快速运行测试
• 搜索名：Code Runner

---

三、开发效率（新手也能变快）

8. Path Intellisense

• 作用：资源文件（图片、布局）路径自动补全
• 新手痛点：写R.drawable.xxx总写错
• 搜索名：Path Intellisense

9. Error Lens

• 作用：代码错误直接在行内高亮显示，不用 hover
• 新手友好：一眼看到错在哪
• 搜索名：Error Lens

10. Material Icon Theme

• 作用：文件图标美化（Java/Kotlin/XML/Gradle 一目了然）
• 新手体验：项目结构更清晰，必装
• 搜索名：Material Icon Theme

---

四、版本控制（Git 必备）

11. Git Graph

• 作用：可视化 Git 提交历史、分支、合并
• 新手场景：看不懂命令行 Git，用这个点鼠标就行
• 搜索名：Git Graph

---

五、一键复制安装命令（新手直接用）

打开 VSCode →Ctrl+P→ 粘贴下面每一行，回车安装：

ext install vscjava.vscode-java-pack ext install fwcd.kotlin ext install levkosyk.vscode-android-tools ext install naco.gradle-language-support ext install qianghu.xmltools ext install formulahendry.code-runner ext install usernamehw.errorlens ext install phuongle.material-icon-theme ext install mhutchie.git-graph

---

六、新手额外提醒（避坑）

1. VSCode 写 Android 前，必须先装 JDK + Android SDK（Android Studio 里装 SDK 最省事）
2. 环境变量要配：ANDROID_HOME、platform-tools加到 Path
3. 纯新手建议：先用 Android Studio 熟悉流程，再用 VSCode 轻量开发

---

VSCode 搭建 Android 开发环境（零基础一步步照做）

整体流程：安装JDK → 安装Android SDK → 配置环境变量 → VSCode安装插件 → 测试运行项目，全程Windows系统演示，步骤无跳跃。

一、第一步：安装 JDK（Java 运行基础）

Android 项目依赖Java环境，推荐JDK 17（目前Android主流适配版本）

1. 下载地址：微软OpenJDK 17
   选择：Windows x64 MSI 安装包，直接双击安装
2. 安装设置：全程默认下一步即可，无需修改路径，安装程序会自动配置基础环境。
3. 验证安装
   按下Win+R输入cmd打开命令行，执行：

   java -version

   输出版本号openjdk 17.x.x即为成功。

二、第二步：安装 Android SDK（核心开发工具包）

VSCode 本身不带SDK，最简方式：借助 Android Studio 安装SDK（不用完整使用AS，只拿SDK）

1. 下载 Android Studio：官网下载
2. 安装流程
   • 双击安装包，一路下一步，默认安装路径即可
   • 首次启动选择Do not import settings→ 点击 OK
   • 进入安装向导，选择Standard（标准模式）（新手首选）→ 下一步
   • 确认组件包含Android SDK，继续下一步，同意协议后开始下载（耗时几分钟，耐心等待）
3. 找到SDK根目录（重点，后续配环境变量要用）
   默认路径（复制保存）：

   C:\Users\你的用户名\AppData\Local\Android\Sdk

   替换成你电脑的用户名即可。

补充：不想装Android Studio？可单独下载SDK Command Line Tools，新手优先上面方案，避坑最多。

三、第三步：配置系统环境变量（关键，必做）

1. 打开环境变量面板

Win10/11：右键此电脑→ 属性 → 高级系统设置 → 环境变量

2. 新建系统变量

在系统变量区域点击「新建」

• 变量名：ANDROID_HOME
• 变量值：粘贴上面找到的SDK根目录（例：C:\Users\XXX\AppData\Local\Android\Sdk）
  点击确定保存。

3. 编辑 Path 变量

1. 系统变量列表里找到Path，双击打开
2. 依次新增两条路径（根据你的SDK目录对应修改）：

   %ANDROID_HOME%\platform-tools %ANDROID_HOME%\tools

3. 全部窗口点击「确定」关闭，环境变量生效需要重启CMD/VSCode。

4. 验证SDK环境

重新打开CMD，执行以下两个命令，无报错即配置成功：

adb --version

sdkmanager --version

四、第四步：VSCode 批量安装插件

1. 打开 VSCode，快捷键Ctrl+Shift+P，输入Install Extensions打开插件市场
2. 快捷键Ctrl+P，逐行粘贴下方命令，回车自动安装（懒人一键方案）：

ext install vscjava.vscode-java-pack ext install fwcd.kotlin ext install levkosyk.vscode-android-tools ext install naco.gradle-language-support ext install qianghu.xmltools ext install formulahendry.code-runner ext install usernamehw.errorlens ext install phuongle.material-icon-theme ext install mhutchie.git-graph

3. 所有插件安装完成后，重启VSCode。

五、第五步：模拟器/真机准备（运行App必备）

方案A：使用安卓模拟器（推荐新手，不用手机）

1. 回到 Android Studio，顶部菜单：Tools → Device Manager
2. 点击Create device，选择一款手机机型（比如Pixel 5）→ 下一步
3. 选择系统镜像（推荐 Android 13），下载后完成创建
4. 点击设备右侧▶️ 启动模拟器，等待开机。

方案B：连接安卓真机

1. 手机开启开发者选项 + USB调试（不同品牌路径略有差异，自行百度对应机型）
2. 手机用USB连接电脑，CMD执行adb devices，能看到设备编号即连接成功。

六、第六步：导入Android项目 & 测试运行

1. 导入项目

1. 准备一个标准 Android 项目（可先用Android Studio新建一个空项目，最简单）
2. VSCode：文件 → 打开文件夹，选中整个Android项目根目录。
3. 首次加载会自动索引Gradle、Java/Kotlin文件，右下角有进度条，等待完成（首次较慢）。

2. 运行应用

1. 打开左侧Android面板（安装Android Tools for VS Code后会出现）
2. 顶部选择已启动的模拟器/真机设备
3. 点击Run App，自动编译、安装并启动App。
4. 模拟器/手机上看到默认页面，代表整套环境搭建完成！

七、新手高频避坑总结

1. 环境变量不生效：修改环境变量后，必须关闭所有CMD、VSCode再重新打开。
2. adb 命令找不到：检查platform-tools路径是否正确写入Path。
3. 项目加载报错：大概率是JDK版本不匹配，统一使用JDK17即可。
4. 模拟器启动失败：电脑开启CPU虚拟化（BIOS里设置，大部分笔记本默认关闭）。
5. Gradle下载慢：可在项目build.gradle配置国内镜像源加速。

八、补充：简易镜像配置（解决下载卡顿）

打开项目根目录build.gradle(Project级别)，替换 repositories 内容，加速依赖下载：

repositories{maven{url 'https://maven.aliyun.com/repository/google'}maven{url 'https://maven.aliyun.com/repository/jcenter'}maven{url 'https://maven.aliyun.com/repository/public'}}