Android SharedPreferences 存儲字符串集合的正確姿勢

需求場景

需要持久化保存多個名字字符串，支持增刪改查，適用於「最近搜索」、「標籤歷史」等場景。

核心 API：getStringSet / putStringSet

Android API Level 11+ (Honeycomb) 引入 Set<String> 支持，不再需要手動拼接分隔符。

完整實現代碼

1. 保存名字集合

public void saveNames(Context context, Set<String> names) {
    SharedPreferences sp = context.getSharedPreferences("name_prefs", Context.MODE_PRIVATE);
    SharedPreferences.Editor editor = sp.edit();
    editor.putStringSet("saved_names", names); // 直接存 Set
    editor.apply(); // 異步提交，不阻塞主線程
}

2. 讀取名字集合

public Set<String> loadNames(Context context) {
    SharedPreferences sp = context.getSharedPreferences("name_prefs", Context.MODE_PRIVATE);
    // 返回不可修改的 Set，需拷貝後操作
    return new HashSet<>(sp.getStringSet("saved_names", new HashSet<>()));
}

3. 添加單個名字

public void addName(Context context, String name) {
    Set<String> names = loadNames(context);
    names.add(name);
    saveNames(context, names);
}

4. 刪除單個名字

public void removeName(Context context, String name) {
    Set<String> names = loadNames(context);
    names.remove(name);
    saveNames(context, names);
}

關鍵注意點（避坑指南）

進階：封裝為工具類

public class NamePrefs {
    private static final String PREFS_NAME = "name_prefs";
    private static final String KEY_NAMES = "saved_names";
    private final SharedPreferences sp;

    public NamePrefs(Context context) {
        sp = context.getSharedPreferences(PREFS_NAME, Context.MODE_PRIVATE);
    }

    public Set<String> getAll() {
        return new HashSet<>(sp.getStringSet(KEY_NAMES, Collections.emptySet()));
    }

    public void add(String name) {
        Set<String> set = getAll();
        set.add(name);
        sp.edit().putStringSet(KEY_NAMES, set).apply();
    }

    public void remove(String name) {
        Set<String> set = getAll();
        set.remove(name);
        sp.edit().putStringSet(KEY_NAMES, set).apply();
    }

    public void clear() {
        sp.edit().remove(KEY_NAMES).apply();
    }
}

適用性評估

• ✅ 數據量小（< 1000 條）、結構簡單、頻繁讀寫
• ❌ 數據量大、需查詢/排序、多進程共享 → 改用 Room/SQLite

掌握 getStringSet/putStringSet，輕鬆實現字符串集合持久化，告別手動拼接分隔符的繁瑣與易錯。