VS Code无法创建Java Gradle项目，gradle命令未被系统识别

1. 环境变量配置准确性校验 #

• 确认GRADLE_HOME系统变量指向Gradle安装根目录（如C:\gradle-8.14.4），不要包含bin子目录
• 检查系统变量Path中是否添加了%GRADLE_HOME%\bin，必须在系统变量而非用户变量下配置（多用户环境下用户变量仅对当前用户生效）
• 确保Gradle安装路径无空格、中文或特殊字符，当前C盘根目录的路径格式是合规的，重点核对拼写是否完全正确

2. 终端与VS Code的重启要求 #

• 环境变量修改后，必须关闭所有已打开的终端（包括VS Code内置终端）并重新打开，新配置才会生效
• 如果VS Code是在配置环境变量前启动的，仅重启终端可能无效，需要完全关闭VS Code后重新启动

3. 环境变量生效验证 #

打开新的命令提示符（CMD），执行以下命令：

echo %GRADLE_HOME%
echo %Path%

• 检查输出中是否存在正确的Gradle根目录，以及%GRADLE_HOME%\bin是否在Path列表内
• 若输出为空或路径错误，说明环境变量配置未成功，重新检查系统变量的设置步骤

4. 直接执行Gradle可执行文件测试 #

导航到Gradle的bin目录执行命令，验证Gradle本身是否正常：

cd C:\gradle-8.14.4\bin
gradle -v

• 若此处能正常输出版本信息，说明Gradle安装无问题，问题出在环境变量的全局生效环节
• 若此处仍报错，大概率是安装包损坏，重新下载官方压缩包解压安装

5. VS Code扩展的Gradle路径配置 #

• 打开VS Code设置（快捷键Ctrl+,），搜索gradle.home，手动指定Gradle安装路径（C:\gradle-8.14.4）
• 该配置可让扩展直接定位Gradle，绕过系统环境变量的生效问题

6. 安装目录权限排查（少见但需确认） #

• 右键Gradle安装目录→属性→安全，确认当前用户拥有读取和执行权限
• 避免因权限不足导致系统无法识别可执行文件

内容的提问来源于stack exchange，提问作者eddie felson