配置:shared_preferences_android项目失败，用户名特殊字符致路径问题求助

一、用户名含不完整括号的目录访问问题 #

• 用引号包裹路径：执行cd命令时，把带特殊字符的路径用双引号括起来，比如：

  cd "C:\Users\BoneteJobertJanne(St"
  

  这样终端会将整个路径视为单一字符串，不会把括号当作语法符号解析。
• 修改Gradle缓存目录：如果不想每次操作都加引号，可设置环境变量GRADLE_USER_HOME，指向一个无特殊字符的目录。比如Windows命令行临时设置：

  set GRADLE_USER_HOME=D:\Gradle_Cache
  

  也可以在系统环境变量中永久配置，让Gradle将缓存、配置文件存到新目录，彻底避开用户名里的特殊字符。

二、shared_preferences_android构建异常修复 #

1. 清理Gradle缓存并刷新依赖 #

• 手动删除旧缓存：删除路径C:\Users\BoneteJobertJanne(St\.gradle\caches下的全部内容；
• 强制刷新依赖：在项目根目录执行命令：

  gradlew build --refresh-dependencies
  

  或在Android Studio中点击File -> Sync Project with Gradle Files重新同步项目。

2. 修正Gradle配置问题 #

• 统一Kotlin版本：检查项目根目录的build.gradle，确保classpath中的Kotlin版本与模块使用的版本一致（比如模块用1.5.31，根目录也要对应）：

  buildscript {
      dependencies {
          classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.5.31"
      }
  }
  

• 确保应用Android插件：检查:shared_preferences_android模块的build.gradle，开头必须应用Android库插件，否则会找不到android属性：

  plugins {
      id 'com.android.library'
      id 'kotlin-android'
  }
  

  旧版写法需添加apply plugin: 'com.android.library'。

3. 解决依赖下载问题 #

• 若网络环境导致Maven仓库访问不畅，可在根目录build.gradle中添加国内镜像源：

  repositories {
      maven { url 'https://maven.aliyun.com/repository/public/' }
      mavenCentral()
  }
  

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