Java文件被识别为Plain Text的根源是文件类型关联丢失或SDK未配置，需依次检查Settings→Editor→File Types中*.java是否误归Plain Text、Project Structure中SDK是否有效配置、filetype.xml是否损坏、插件是否冲突。
Java文件被识别为Plain Text而不是Java文件
IDE把.java文件当纯文本处理，最直接的表现就是：没有语法高亮、无代码补全、Ctrl+点击不跳转——本质是文件类型关联丢了。IntelliJ IDEA（含Android Studio）里这问题常见于手动修改过文件关联、导入旧项目、或插件冲突后。
- 先去
Settings > Editor > File Types，在右侧“Registered Patterns”里搜*.java，确认它是否被错误地归到了Plain Text类型下 - 如果找到了，选中那条
*.java，点上方减号-删除它 - 再找到
Java类型，在其“Registered Patterns”里确保有*.java（没有就点加号+手动加） - 改完别忘了点
OK，且要重启IDE（仅应用不生效）
项目SDK未正确配置导致Java高亮失效
即使文件类型对了，如果项目没绑定JDK，IDE仍可能降级为纯文本渲染——尤其新建空项目或从Git拉取未带.idea配置的仓库时。
- 打开
Project Structure > Project，检查Project SDK是否为有效JDK（不是No SDK或灰色不可选状态） - 若为空，点右侧
New... > JDK，定位到JDK安装路径（如/usr/lib/jvm/java-17-openjdk-amd64或C:\Program Files\Java\jdk-17） - 同时确认
Project language level与SDK匹配（比如JDK 17对应17 (Switch expressions)） - 顺手检查模块设置：
Project Structure > Modules > Sources标签页里，src目录是否被标记为Sources（蓝色图标），否则Java文件不会被当作源码处理
filetype.xml被意外修改或损坏
极少数情况，IDE的本地配置文件 filetype.xml 被手动编辑出错，会导致所有文件类型关联批量失效。现象是：不止.java，连.xml、.json也变白板。
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 关闭IDE，找到配置目录：
~/.config/JetBrains/IntelliJIDEA2023.3/options/filetype.xml（Linux/macOS）或%APPDATA%\JetBrains\IntelliJIDEA2023.3\options\filetype.xml（Windows） - 备份原文件，然后删掉它（IDE下次启动会重建默认配置）
- 不要用文本编辑器直接改这个文件——节点嵌套深，一个
漏写就会让整个文件失效 - 重建后首次启动稍慢，IDE会重新索引并恢复默认关联
插件干扰（特别是TextMate Bundles或自定义语言插件）
装了非官方语法插件后，有时会劫持.java的解析逻辑，比如某些老旧的TextMate插件会强行把Java文件映射到自定义scope，绕过IDE原生高亮引擎。
立即学习“Java免费学习笔记（深入）”；
- 进
Settings > Plugins，临时禁用所有非JetBrains官方插件（尤其是名字带TextMate、Language Support、Syntax Highlighter的） - 禁用后重启，看Java文件是否恢复颜色；逐个启用排查，定位冲突插件
- 已知冲突插件示例：
TextMate bundles（新版IDE已不兼容）、Java Bytecode Viewer（某些版本会覆盖文件类型） - 插件作者未适配新版IDE API时，这类问题大概率无解，只能弃用
文件类型关联这事看着小，但一旦错位，IDE就退化成高级记事本。最麻烦的是它不报错，只默默静音——得自己想到去查File Types，而不是盯着代码找bug。
