Android Navigation组件中Fragment未显示在列表的问题排查

我来帮你排查这个问题，结合你提供的配置和环境来看，主要有几个可能的原因和对应的解决办法：

1. 依赖版本与Android Studio版本不兼容 #

你使用的Android Studio 3.4.2是比较早期的稳定版本，而搭配的Navigation组件是2.1.0-beta02这个测试版，两者存在兼容性差异——较新的Navigation beta版本通常需要更高版本的Android Studio来支持其编辑器特性。

解决办法：将Navigation组件降级到与AS 3.4.2匹配的稳定版本，比如2.0.1。修改你的模块级build.gradle依赖配置：

def nav_version = "2.0.1"
// Java
implementation "androidx.navigation:navigation-fragment:$nav_version"
implementation "androidx.navigation:navigation-ui:$nav_version"
// Kotlin
implementation "androidx.navigation:navigation-fragment-ktx:$nav_version"
implementation "androidx.navigation:navigation-ui-ktx:$nav_version"

修改完成后点击工具栏的Sync Now同步项目，再打开导航图编辑器查看可选Fragment列表。

2. Android Studio导航编辑器缓存异常 #

AS的Navigation Editor偶尔会出现缓存问题，导致无法正确识别项目中的Fragment。

解决办法：清理AS缓存并重启：

• 点击顶部菜单栏的File -> Invalidate Caches / Restart
• 在弹出的窗口中选择Invalidate and Restart，等待AS重启完成后再检查导航图。

3. 确认Fragment继承的是AndroidX版本 #

Navigation组件仅支持AndroidX体系的Fragment，需要确保你的BlankFragment2继承自androidx.fragment.app.Fragment，而不是旧的android.app.Fragment。检查你的Fragment代码中的import语句：

import androidx.fragment.app.Fragment // 正确的导入
// import android.app.Fragment // 错误的导入，需替换

按照以上步骤逐一排查，应该就能解决Fragment不显示在可选列表的问题了。

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