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

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

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

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

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

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

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

下载地址：微软OpenJDK 17
选择：Windows x64 MSI 安装包，直接双击安装
安装设置：全程默认下一步即可，无需修改路径，安装程序会自动配置基础环境。
验证安装
按下 Win+R 输入 cmd 打开命令行，执行：
复制代码
```
java -version
```
输出版本号 openjdk 17.x.x 即为成功。

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

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

下载 Android Studio：官网下载
安装流程
- 双击安装包，一路下一步，默认安装路径即可
- 首次启动选择 Do not import settings → 点击 OK
- 进入安装向导，选择 Standard（标准模式）（新手首选）→ 下一步
- 确认组件包含 Android SDK，继续下一步，同意协议后开始下载（耗时几分钟，耐心等待）
找到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 变量

系统变量列表里找到 Path，双击打开
依次新增两条路径 （根据你的SDK目录对应修改）：
复制代码
```
%ANDROID_HOME%\platform-tools
%ANDROID_HOME%\tools
```
全部窗口点击「确定」关闭，环境变量生效需要重启CMD/VSCode。

4. 验证SDK环境

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

复制代码

adb --version

sdkmanager --version

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

打开 VSCode，快捷键 Ctrl+Shift+P，输入 Install Extensions 打开插件市场
快捷键 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
所有插件安装完成后，重启VSCode。

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

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

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

方案B：连接安卓真机

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

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

1. 导入项目

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

2. 运行应用

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

七、新手高频避坑总结

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

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

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

java 复制代码

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' }
}