League CSV无需单独安装Composer，直接composer require league/csv即可，但v9+版本对BOM、Windows换行符及多行字段敏感，需手动清理BOM、显式设置分隔符与引号、使用流式解析并注意Excel乱码时加BOM。
League CSV 不需要单独安装 Composer，它本身就是 Composer 包；直接 composer require league/csv 就行，但默认安装的版本可能不兼容 PHP 8.2+ 或带 BOM 的文件，得手动调参数。
为什么 composer require league/csv 装完读 CSV 会报错？
常见错误是 Invalid argument supplied for foreach() 或空数组、乱码、跳过首行——多半因为新版 league/csv（v9+）默认用 Reader::createFromFileObject()，底层依赖 fgetcsv()，而它对 UTF-8 BOM、Windows 换行符（\r\n）、字段含换行符的处理很敏感。
- PHP 8.2+ 下若没显式设置
ini_set('auto_detect_line_endings', '1')，fgetcsv()可能读断行 - 带 BOM 的 UTF-8 文件会被当乱码，
Reader不自动 strip BOM - v9 默认用
Reader::createFromPath()返回的是只读对象，不能直接->fetchOne()，得先->getRecords()或->setOffset()
怎么安全读取带 BOM / Windows 换行 / 多行字段的 CSV？
核心是绕过 fgetcsv() 的坑，改用流式解析 + 手动 BOM 清理。别依赖默认行为。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 用
fopen()打开文件后，先fseek($fp, 0)再检查前3字节是否为 BOM（\xEF\xBB\xBF），是则fread($fp, 3)跳过 - 创建
Reader时传入已去 BOM 的流：Reader::createFromStream($fp)，不是createFromPath() - 调用
$reader->setDelimiter(',')和$reader->setEnclosure('"')显式声明，别信自动检测 - 如果字段含换行符，确保 CSV 是 RFC 4180 合规格式（字段用双引号包裹），否则
league/csv会解析失败
示例关键片段：
$fp = fopen('data.csv', 'r');
if (fgets($fp, 4) === "\xEF\xBB\xBF") {
// skip BOM
} else {
fseek($fp, 0);
}
$reader = Reader::createFromStream($fp);
$reader->setDelimiter(';'); // 注意分隔符
foreach ($reader->getRecords() as $row) {
// 正常处理
}
写 CSV 时中文乱码、Excel 打不开怎么办？
Excel 默认只认 GBK/GB2312，但 PHP 一般用 UTF-8 —— 直接写 UTF-8 会导致 Excel 显示乱码，除非加 BOM；但加了 BOM 又可能被其他程序当异常字符。
- 写入前必须转 UTF-8：用
mb_convert_encoding($str, 'UTF-8', 'auto')统一源数据编码 - 写入时用
Writer::createFromPath()，然后$writer->addBom()强制加 BOM（仅对 Excel 有效） - 如果目标系统是 Linux 或 Web 展示，别加 BOM，改用
header('Content-Type: text/csv; charset=utf-8')告诉浏览器 - 避免用
$writer->insertOne()循环写，性能差；改用$writer->insertAll($rows)批量写入
最麻烦的其实是字段里混了双引号和换行符，league/csv 会帮你转义，但前提是你的输入已经按 RFC 规范包裹好——很多人漏掉这步，结果 Excel 里整行错位。别嫌烦，写之前用 str_replace('"', '""', $field) 手动转义双引号，再包一层 "{$field}"，这才是稳的。
