fgetcsv()是PHP原生处理CSV最稳妥方案，需注意编码（过滤BOM）、行结束符、不限行长、手动跳过空行/注释行、流式读取防内存溢出、批量插入及环境编码对齐。
用 fgetcsv() 读 CSV 最稳妥
PHP 原生处理 CSV，fgetcsv() 是唯一推荐的起点。它按行解析、自动处理引号包裹字段、逗号嵌套、换行符等边界情况，比 file_get_contents() + explode() 或正则强太多。
常见错误是忽略文件编码和 BOM：UTF-8 带 BOM 的 CSV 会导致第一行字段名莫名多出 \u{feff}；Windows 换行（\r\n）在某些 PHP 版本下可能被截断——必须显式设置行结束符。
- 打开文件前加
stream_filter_append($fp, 'convert.iconv.UTF-8/UTF-8//IGNORE')过滤非法字节（仅限 PHP 8.1+；老版本用mb_convert_encoding()预处理） - 调用
fgetcsv($fp, 0, ',', '"', '"')—— 第二个参数设为0表示不限制行长度，避免长字段被截断 - 若 CSV 头行是中文字段名，后续用
array_combine()构建关联数组时，确保键名已去除 BOM 和首尾空格
跳过空行和注释行要自己判断
fgetcsv() 不会主动跳过空行或以 # 开头的注释行，它只管按 CSV 规则拆字段。实际数据里常混着说明、分隔线、空行，直接进循环会崩掉 array_combine() 或引发 Notice: Undefined offset。
典型场景：运营导出的 Excel 另存为 CSV，前 3 行可能是标题、时间戳、空行；最后一行可能是“合计：xxx”。
立即学习“PHP免费学习笔记（深入）”；
把记录数组导出为带样式的 Excel(xlsx) 或带 BOM 的 CSV。支持列配置（表头/宽度/顺序）、表头冻结首行、斑马纹、布尔值转「是/否」、数组换行、CSV 中文防乱码。零依赖。触发词：导出 Excel、导出 CSV、记录转表格、列配置导出、数据导出、表格美化、JSON 转表格。
- 读取每行后先检查
$row === null（文件末尾）或empty(array_filter($row))（全空行） - 用
trim($row[0] ?? '') === ''或str_starts_with(trim($row[0] ?? ''), '#')过滤注释行 - 别依赖
count($row) === 1 && $row[0] === ''判空行——CSV 允许字段为空字符串，但整行未必空
内存不够时别用 file() 全读进数组
动辄几十万行的 CSV，用 file('data.csv') 会把整个文件塞进内存，PHP 报 Fatal error: Allowed memory size exhausted。哪怕加了 ini_set('memory_limit', '-1')，也只是把崩溃延后，且拖慢响应。
真实使用场景：后台定时导入用户数据、日志分析脚本、离线报表生成——这些都不该卡住 Web 请求生命周期。
- 坚持用
fopen()+fgetcsv()流式读取，每处理一行就释放该行变量引用 - 批量插入数据库时，攒够 1000 行再执行一次
INSERT INTO ... VALUES (),(),...，别每行都INSERT - 需要随机访问某行？别硬扛——先用
awk 'NR==1000' data.csv或sed -n '1000p'命令行预筛，再交给 PHP 处理
中文字段名和乱码不是函数问题，是环境没对齐
显示 “æ个å段” 或字段名变成 æ个，99% 是 PHP 脚本文件编码、CSV 文件编码、Web 输出编码三者不一致。跟 fgetcsv() 本身无关，它只负责拆字段，不管字节含义。
最容易被忽略的是：Apache/Nginx 返回的 Content-Type 响应头默认不带 ; charset=utf-8，浏览器就按 ISO-8859-1 解码，中文全变方块。
- 确认 CSV 文件本身是 UTF-8 无 BOM：用 VS Code 底部状态栏看，或
file -i data.csv查看 - PHP 脚本开头加
header('Content-Type: text/plain; charset=utf-8');（调试用）或mb_internal_encoding('UTF-8'); - 如果用
echo json_encode($data)输出给前端，必须加JSON_UNESCAPED_UNICODE参数，否则中文变\uXXXX
CSV 解析本身没玄学，坑全在编码、换行、内存、空行这四点上。哪点松动，后面全跟着错。
