Android Material3浅色主题ListView项文本不显示及ContentProvider咨询

一、列表项文本不显示的排查与解决 #

你当前的核心问题并非主题颜色配置，而是代码中存在字段不匹配的错误：
在insertNote方法中，你向数据库插入的是NotesTable.NOTE_CREATED字段：

values.put(NotesTable.NOTE_CREATED, noteText);

但在SimpleCursorAdapter的from数组中，你指定要读取的是NotesTable.NOTE_TEXT字段：

String[] from = {NotesTable.NOTE_TEXT};

这直接导致Cursor中NOTE_TEXT字段无数据，自然无法显示列表项文本。

修复步骤： #

1. 统一字段匹配：
   二选一修改即可：

   • 修改插入逻辑，将内容存入NOTE_TEXT字段：

     values.put(NotesTable.NOTE_TEXT, noteText);
     

   • 或者修改适配器的字段映射，读取NOTE_CREATED字段：

     String[] from = {NotesTable.NOTE_CREATED};
     

2. 字段匹配后仍无文本的主题检查：
   若确认字段一致后仍看不到文本，再排查主题颜色：Material3浅色主题中，android:textColorPrimary控制正文文本颜色，需确认@color/text_color_primary的颜色值与ListView背景色（默认白色）有足够对比度。可临时替换为系统黑色测试：

   <item name="android:textColorPrimary">@android:color/black</item>
   

二、ContentProvider是否过时？替代方案是什么？ #

ContentProvider并未完全淘汰，但它的核心定位是跨应用数据共享（如系统联系人、媒体库这类需要对外暴露数据的场景）。对于单应用内的数据库操作，现在更推荐使用Room Persistence Library，优势如下：

• 是Google官方ORM框架，封装SQLite，无需手动编写Cursor、ContentProvider这类繁琐代码；
• 支持LiveData、Flow等响应式组件，自动感知数据变化并更新UI；
• 编译期检查SQL语法，提前规避错误；
• 贴合现代Android MVVM架构，便于数据层与UI层解耦。

Room基础使用示例： #

1. 定义实体类：

@Entity(tableName = "notes")
public class Note {
    @PrimaryKey(autoGenerate = true)
    public long id;
    public String noteText;
    public long createdAt;
}

2. 定义Dao接口：

@Dao
public interface NoteDao {
    @Insert
    long insert(Note note);
    
    @Query("SELECT * FROM notes")
    LiveData<List<Note>> getAllNotes();
}

3. 定义数据库类：

@Database(entities = {Note.class}, version = 1)
public abstract class AppDatabase extends RoomDatabase {
    public abstract NoteDao noteDao();
    
    private static volatile AppDatabase INSTANCE;
    public static AppDatabase getInstance(Context context) {
        if (INSTANCE == null) {
            synchronized (AppDatabase.class) {
                if (INSTANCE == null) {
                    INSTANCE = Room.databaseBuilder(context.getApplicationContext(),
                            AppDatabase.class, "notes_db").build();
                }
            }
        }
        return INSTANCE;
    }
}

4. 在Activity中使用：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    
    // 插入数据
    Note note = new Note();
    note.noteText = "New note";
    note.createdAt = System.currentTimeMillis();
    AppDatabase.getInstance(this).noteDao().insert(note);
    
    // 观察数据变化并更新UI（推荐用RecyclerView替代ListView）
    AppDatabase.getInstance(this).noteDao().getAllNotes().observe(this, notes -> {
        // 用RecyclerView.Adapter更新列表
    });
}

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