Android Studio配置错误：无法转换相对路径，Kotlin项目改名后遇Gradle问题

• 检查local.properties文件
  项目根目录下的local.properties是存储SDK路径的核心配置文件，修改名称后大概率导致这里的路径变成了无效相对路径。打开该文件，找到sdk.dir行，将其替换为Android SDK的绝对路径：

  • Windows系统示例：sdk.dir=C:\\Users\\你的用户名\\AppData\\Local\\Android\\Sdk
  • Mac系统示例：sdk.dir=/Users/你的用户名/Library/Android/sdk
    注意路径斜杠格式：Windows用双反斜杠，Mac用正斜杠。

• 修正settings.gradle.kts中的路径配置
  打开项目根目录的settings.gradle.kts，检查include和project相关配置，确保所有模块的引用路径与实际文件夹名称完全匹配。比如改了模块名称后，include(":app")要对应新的模块文件夹名，不能保留旧名称或错误相对路径。

• 清理缓存并同步Gradle

  1. 点击Android Studio顶部菜单栏File -> Invalidate Caches...，勾选Invalidate and Restart选项后重启IDE。
  2. 重启完成后，再次点击File -> Sync Project with Gradle Files，让IDE重新加载正确配置。

• 核对模块build.gradle.kts配置
  打开app模块下的build.gradle.kts，确认namespace、applicationId、defaultConfig里的名称配置，确保和修改后的应用名称一致，没有引用旧路径或旧名称。

额外提示 #

后续修改项目/模块名称时，优先使用Android Studio自带的Refactor -> Rename功能，它会自动同步所有配置文件的路径和名称，避免手动修改引发的配置混乱。

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