Kotlin开发Android在MainActivity引用btnDatePicker报Unresolved reference错误

补充说明：你遇到的Unresolved reference: btnDatePicker是编译期错误，不是运行时抛出的，也就是说代码根本没有进入运行阶段，在编译环节就因为找不到对应引用被拦截了

这个报错的核心成因是：你当前的项目没有配置让布局控件id自动映射为Kotlin可直接调用对象的能力，这种自动映射不是Android/Kotlin的原生默认能力，必须手动开启对应配置才能生效，且谷歌早已废弃了旧的映射方案，需要用官方现在推荐的方式实现。

基础排查步骤 #

• 确认布局文件路径正确：你写的带btnDatePicker的布局必须放在res/layout/activity_main.xml路径下，不要错放到res的其他子目录、或者改了布局文件名和setContentView(R.layout.activity_main)传入的文件名不匹配。
• 确认id拼写完全一致：布局里定义的id是@+id/btnDatePicker，要和你代码里写的名称大小写、拼写完全相同，不要漏字母、大小写颠倒。
• 清理缓存重新编译：Android Studio经常会出现R类生成缓存异常的问题，依次点击顶部菜单栏Build -> Clean Project，等清理完成后再点Rebuild Project，全量重新编译一次后再查看报错是否消失。

官方推荐的正确控件使用方式 #

从Android Studio 4.1版本开始，谷歌已经完全废弃了早年可以直接写控件id当对象用的kotlin-android-extensions插件，现在新创建的项目默认根本不支持这种写法，要实现控件绑定，需要开启View Binding功能：

1. 打开app模块下的build.gradle文件，在android配置块中添加View Binding开启配置：

android {
    // 保留你原有的其他配置内容
    buildFeatures {
        viewBinding true
    }
}

2. 点击Gradle同步按钮，等依赖配置同步完成后，系统会自动为每个布局文件生成对应的绑定类，你需要把MainActivity里的代码改成下面的形式：

class MainActivity : AppCompatActivity() {
    // 声明当前布局对应的View Binding实例
    private lateinit var activityMainBinding: ActivityMainBinding

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // 初始化绑定实例，替换原来直接setContentView的写法
        activityMainBinding = ActivityMainBinding.inflate(layoutInflater)
        setContentView(activityMainBinding.root)

        // 所有控件都通过绑定实例引用，不需要直接写控件id
        activityMainBinding.btnDatePicker.setOnClickListener {
            Toast.makeText(this, "works", Toast.LENGTH_LONG).show()
        }
    }
}

关于IDE弹出的自动修复选项 #

你悬停报错代码时IDE弹出的所有修复选项（比如创建成员变量、导入不存在的包之类）都不要选。这些选项的逻辑是给不存在的btnDatePicker变量手动创建一个空对象，根本没有和你的布局按钮做绑定，就算选了这些选项让代码不再报红，运行时也会直接抛出空指针崩溃。

注意：如果你之前参考的是几年前的旧教程，里面提到的import kotlinx.android.synthetic.main.activity_main.*导包后直接用id的写法，现在已经完全失效，不要再按照旧教程去配置已经被废弃的插件。

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