nginx不支持utf-8 bom编码，配置文件含bom会导致报错“unknown directive ‘user’”，需用file、hexdump识别bom，再用iconv或vim清除，编辑器应设为utf-8无bom格式。
Nginx 本身不支持带 BOM（Byte Order Mark）的 UTF-8 文件，一旦配置文件（如 nginx.conf 或 include 的子配置）以 UTF-8 with BOM 编码保存，Nginx 在 reload 或 start 时会直接报错，常见错误如：
nginx: [emerg] unknown directive "user" in /etc/nginx/nginx.conf:1
这是因为 BOM（EF BB BF）被当作普通字符读入，导致首行开头出现不可见乱码，Nginx 将其误认为指令名。排查和修复都很明确，关键在「快速识别 + 无损清除」。
用 hexdump 或 file 快速确认是否含 BOM
进入 Nginx 配置目录（如 /etc/nginx/），对可疑文件执行：
-
file -i nginx.conf—— 若输出含charset=utf-8-with-bom或类似描述，基本可判定 -
hexdump -C nginx.conf | head -n 2—— 查看前几个字节：若开头是ef bb bf，就是 UTF-8 BOM -
head -n1 nginx.conf | cat -A—— 若第一行开头显示^M或等异常符号，也提示 BOM 存在
用 iconv 或 vim 安全去除 BOM
推荐使用无损、可逆的方式清除，避免改乱原有中文或注释：
-
iconv -f UTF-8 -t UTF-8//IGNORE nginx.conf -o nginx.conf.no-bom && mv nginx.conf.no-bom nginx.conf（较稳妥，自动跳过非法序列） -
vim nginx.conf→ 输入:set nobomb→:wq（vim 会自动重写为无 BOM 的 UTF-8） - 不建议用 sed 直接删头三字节（
sed -i '1s/^\xEF\xBB\xBF//' nginx.conf），除非确认文件一定是 UTF-8 且仅开头有 BOM；否则可能误删合法内容
批量检查所有 .conf 文件
配置常分散在多个文件（sites-enabled/、conf.d/），可用以下命令一次性扫描：
find /etc/nginx -name "*.conf" -exec file -i {} \; | grep -i bom- 或更精准：
find /etc/nginx -name "*.conf" -exec sh -c 'head -c 3 "$1" | od -t x1 | grep "ef bb bf" >/dev/null && echo "BOM found: $1"' _ {} \;
预防后续再引入 BOM
编辑器默认行为是隐患源头，需统一规范：
- VS Code：设置
"files.encoding": "utf8"，并关闭"files.autoGuessEncoding"（避免误判） - Notepad++：编码 → 转为 UTF-8 无 BOM 格式 → 保存
- Linux 终端常用 vim/nano：无需额外配置，但若从 Windows 复制粘贴内容，务必先用
dos2unix或iconv清理 - CI/CD 中可加校验步骤，例如用
grep -l $'\xEF\xBB\xBF' /etc/nginx/**/*.conf做预检
只要一次定位到带 BOM 的文件并清除，Nginx 就能正常加载。问题不复杂，但容易因编辑器静默插入而反复发生。
