IntelliJ中FabricMC模组开发报错：无法解析符号'CottonClientScreen'

问题概述 #

在Manjaro Linux上使用IntelliJ IDEA开发Fabric模组，添加CottonMC LibGui依赖后，出现Cannot resolve symbol 'CottonClientScreen'错误，已尝试执行./gradlew genSources、重启IDE清缓存、IntelliJ依赖搜索工具等操作未解决。

解决方案 #

1. 强制刷新Gradle依赖并重新构建 #

依赖未正确拉取是常见原因，执行以下命令强制刷新：

./gradlew clean build --refresh-dependencies

完成后重新生成源码：

./gradlew genSources

2. 验证LibGui版本与MC版本兼容性 #

确保build.gradle中LibGui版本与项目的minecraft_version完全匹配：

• 若你的MC版本是1.19，当前使用的6.3.0+1.19是正确的
• 若为1.19.1/1.19.2，需更换对应版本（例如6.4.0+1.19.2），可参考LibGui官方发布的版本对应关系

3. 调整Gradle依赖配置格式 #

将依赖声明拆分为两行，避免include嵌套可能的解析问题：

dependencies {
    // ... 其他依赖
    modImplementation "io.github.cottonmc:LibGui:6.3.0+1.19"
    include "io.github.cottonmc:LibGui:6.3.0+1.19"
}

4. 同步IDE与Gradle项目 #

在IntelliJ中执行：

• 点击右侧Gradle面板的🔄（Refresh）按钮
• 或通过菜单File -> Sync Project with Gradle Files

5. 彻底清理IDE缓存 #

执行File -> Invalidate Caches...，勾选以下选项后重启IDE：

• Invalidate and Restart
• 勾选"Clear file system cache and local history"

验证步骤 #

完成上述操作后，检查Java类中的导入语句：

import io.github.cottonmc.cotton.gui.client.CottonClientScreen;

确认错误消失后，可尝试创建CottonClientScreen实例验证功能正常。

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