IntelliJ IDEA新建Gradle项目报Error adding module错误如何解决

问题根因 #

该报错和JDK 16版本没有关联，核心是路径非法字符校验不通过导致的模块创建失败。

Error adding module to project: illegal char :> at index 23
报错信息明确指向完整项目路径的第23位字符处存在不被支持的特殊符号:>，触发了IntelliJ IDEA以及操作系统的文件名规则校验。
常见触发场景：

• 填写的项目名称中包含:、>、<、*、?、"、|这类被Windows、Unix系统普遍禁止用于文件/文件夹命名的特殊字符
• 选择的项目存储根路径中包含上述特殊字符，例如存在带特殊符号的网盘同步目录、含特殊中文符号的文件夹下

解决方案 #

• 检查项目名称，仅保留字母、数字、下划线、横杠、英文点号作为合法命名字符，删除所有特殊符号
• 检查项目存储的完整路径，确保路径全程没有上述禁止的特殊字符，建议优先使用纯英文无特殊符号的目录作为项目根目录，例如/Users/xxx/projects/kotlin-demo或D:\projects\kotlin-demo这类格式
• 调整后重新走项目创建流程即可正常生成项目

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