VSCode打开Minecraft模组项目时出现URISyntaxException错误求助

问题描述 #

每次在VSCode中打开路径为z:\Projects\minecraft_mods\starting_mod-1.12.2\的Minecraft 1.12.2模组项目时，Java构建后会重复出现两条相同错误：

Could not fetch model of type 'BuildEnvironment' using connection to Gradle distribution 'https://services.gradle.org/distributions/gradle-4.9-bin.zip'.
java.net.URISyntaxException: Illegal character in opaque part at index 2: z:\Projects\minecraft_mods\starting_mod-1.12.2\.
Illegal character in opaque part at index 2: z:\Projects\minecraft_mods\starting_mod-1.12.2\.

修改gradlew.bat中的DIRNAME设置为.后问题依旧。

解决方案 #

1. 修复路径格式（核心解决方向） #

错误根源是Windows盘符路径的反斜杠\在Java URI解析中被判定为非法字符，可通过以下方式处理：

• 打开项目时使用正斜杠路径：将路径改为z:/Projects/minecraft_mods/starting_mod-1.12.2/后再导入VSCode。
• 给路径添加文件URI前缀：用file:///z:/Projects/minecraft_mods/starting_mod-1.12.2/作为打开路径，让Java正确识别为文件URI。

2. 调整Gradle配置文件 #

在项目根目录的gradle.properties中添加以下配置，强制Gradle使用合规的路径格式：

# 替换为你的Java 8 JDK路径，必须用正斜杠
org.gradle.java.home=C:/Program Files/Java/jdk1.8.0_xxx
# 指定项目根目录路径，用正斜杠
systemProp.user.dir=z:/Projects/minecraft_mods/starting_mod-1.12.2

注意：Minecraft 1.12.2模组开发需搭配Java 8，确保JDK路径对应正确版本。

3. 重置VSCode与Gradle状态 #

• 关闭VSCode，删除项目根目录下的.vscode文件夹（建议先备份）。
• 删除用户目录下的Gradle缓存文件夹：C:\Users\你的用户名\.gradle\caches。
• 重新打开VSCode并导入项目，让Gradle重新初始化构建环境。

4. 本地托管Gradle发行包 #

手动下载gradle-4.9-bin.zip到本地目录，修改项目gradle/wrapper/gradle-wrapper.properties中的distributionUrl为本地路径（用正斜杠）：

distributionUrl=file:///C:/gradle/gradle-4.9-bin.zip

避免Gradle每次构建时远程下载路径解析出错。

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