Android Studio自动转换类名大小写如何限制?怎样保留原有类名?
大小写命名冲突解决指南
根本原因
Windows文件系统默认不区分大小写,而Linux文件系统区分大小写,Android Studio 4.2.1导入跨平台项目时会自动合并大小写冲突的文件名,导致原WorkSpace.java被强制重命名为Workspace.java,和代码中的类引用不匹配触发构建报错。
保留原命名的具体可落地方案
- 方案1:开启项目目录的大小写敏感属性(Windows 10 1809及以上版本支持)
- 以管理员身份打开PowerShell,进入项目根目录的父级文件夹
- 执行命令:
fsutil file setCaseSensitiveInfo 你的项目目录名称 enable - 删除本地已被修改的错误项目文件,重新从Git拉取完整代码,此时Windows会识别
WorkSpace.java为独立文件名,不会自动修改大小写
- 方案2:关闭Android Studio的自动合并大小写配置
- 打开Android Studio设置页:
File -> Settings - 依次进入
Editor -> General -> Case Sensitivity,将Case-sensitive completion设置为ALL,取消勾选Assume names in the same case are identical选项 - 进入
Version Control -> Confirmation,取消勾选Rename files in Git when they are renamed in project,避免IDE自动同步修改Git内的文件名
- 打开Android Studio设置页:
- 方案3:快速批量适配方案(适合需要长期跨平台协作的项目)
- 选中项目根目录,右键选择
Replace in Path - 搜索框输入
WorkSpace,替换框输入Workspace,确认所有匹配项都是类名引用后一键替换,上百处引用可在几秒内完成修改,提交Git后可从根源避免后续跨平台大小写冲突问题
- 选中项目根目录,右键选择
注意:如果选择方案1,后续所有对该项目目录的文件操作都需要严格匹配大小写,否则仍可能出现文件识别错误。如果项目需要频繁在Windows和Linux之间跨平台协作,更推荐方案3统一命名规范。
内容的提问来源于stack exchange,提问作者Rajat Mehra
相关产品推荐
相关产品推荐

