codeigniter 2.x 中 distinct() 仅支持整行去重，需显式指定唯一所需字段（如 select('email')）以避免其他字段干扰；它不支持字段级去重、排序后去重或聚合需求，此类场景应改用 group by 或原生查询。
CodeIgniter 2.x 中用 distinct() 去重查询的正确写法
CodeIgniter 2.x 的 Query Builder（即 Active Record）支持 distinct()，但它只作用于整个 SELECT 行，不是字段级去重。如果你写了 $this->db->distinct()->select('name')->from('users')，结果仍是按整行去重——哪怕 name 相同，只要其他隐式选中的字段（比如主键、时间戳）不同，就会被当成不同行。
常见错误现象：distinct() 像没生效一样，返回重复 name；或者误以为它能替代 SQL 的 GROUP BY 或子查询。
- 必须显式调用
select()，且只选需要去重的字段（否则其他字段会干扰去重逻辑） -
distinct()要在select()之前或之后调用都有效，但建议放在select()后、from()前，逻辑更清晰 - 不支持多字段组合去重时“只看其中一列”，那是
GROUP BY的职责
$this->db->distinct();
$this->db->select('email'); // 只选 email，避免其他字段干扰
$this->db->from('users');
$query = $this->db->get();
CodeIgniter 3.x+ 里 distinct() 的行为变化与兼容注意
CI3 开始，distinct() 仍可用，但底层生成的 SQL 更严格：它会把 DISTINCT 放在 SELECT 关键字后，而不是字段前。这意味着如果你手动拼了 select('DISTINCT email')，CI3 会报错或生成非法 SQL。
使用场景：升级项目时发现去重失效，大概率是旧代码混用了手动字符串和 Query Builder。
- 绝对不要写
$this->db->select('DISTINCT email')—— 这绕过了 Query Builder 的语法校验 - CI3+ 中
distinct()是布尔开关，传参无效（如distinct(true)会被忽略） - 若需对表达式去重（如
UPPER(email)），必须用select('UPPER(email) as email', FALSE)+distinct()，且第二个参数FALSE禁用自动转义
真正要“按某字段去重、取最新一条”时，别硬扛 distinct()
distinct() 解决不了“每个 category 取 price 最低的商品”这类问题。它只做行级去重，不提供排序、分组、聚合能力。强行用它会导致数据随机截断，结果不可控。
典型错误操作：先 order_by('created_at', 'DESC') 再 distinct('category_id') —— CI 不支持字段参数，且 SQL 层面 DISTINCT 和 ORDER BY 混用时，排序字段必须出现在 SELECT 列表中，否则报错。
- 正确做法是改用子查询或
group_by()配合聚合函数，例如：$this->db->select('category_id, MAX(price) as max_price')->group_by('category_id') - 如果必须取完整记录（不只是聚合值），得用自连接或窗口函数（CI4 可配合原生查询，CI2/3 建议写
query()执行手写 SQL） - 性能提示：大表上
GROUP BY没索引支撑时比DISTINCT更慢，务必在分组字段建索引
CI4 中用 distinct() 的新限制和替代方案
CI4 的 distinct() 依然是无参方法，但 Query Builder 对字段别名和表达式更敏感。如果你用 select("CONCAT(first_name, ' ', last_name) as full_name") 后调 distinct()，它会对整个拼接结果去重——这有时是想要的，但容易忽略空格、大小写、NULL 导致的意外去重。
容易被忽略的地方：CI4 默认开启严格模式，NULL 值在 DISTINCT 中被视为相同值，但若字段允许 NULL 且业务上要区分“未填”和“空字符串”，就得提前用 COALESCE 处理。
- 处理 NULL：写成
$builder->select("COALESCE(email, 'unknown@example.com') as email") - 忽略大小写去重：用
SELECT DISTINCT LOWER(email) FROM users，对应 CI4 写法是$builder->select("LOWER(email) as email", FALSE)->distinct() - CI4 不再支持
distinct()后链式调用count_all_results()获取去重后总数（会忽略 distinct），必须用count_all_results(FALSE)或先get_compiled_select()调试 SQL
