Symfony 4 翻译文件中文乱码的根本原因是文件含 UTF-8 BOM 头，而 Symfony 要求严格使用 UTF-8 无 BOM 编码；须用 VS Code 或 Notepad++ 保存为“UTF-8（无 BOM）”，并确保 YAML 值用双引号包裹、缩进用空格、运行 lint:translations 校验。
Symfony 4 本地化翻译文件出现编码错误，通常表现为中文乱码、特殊字符显示为问号或方块、控制台报错“invalid UTF-8 sequence”等。根本原因不是 Symfony 不支持中文，而是文件保存编码与框架预期不一致——Symfony 强制要求所有翻译文件必须以 UTF-8 无 BOM 格式保存，哪怕内容全是 ASCII 字符，BOM 头也会导致解析失败。
确认并修正文件编码格式
很多编辑器（如 Windows 记事本、旧版 Sublime Text、某些 IDE 的默认导出）会自动添加 UTF-8 BOM（Byte Order Mark），而 Symfony 的 YAML/XLIFF/PHP 加载器无法跳过它，直接报语法错误或静默忽略翻译项。
- 用 VS Code 打开翻译文件 → 右下角点击编码名称（如“UTF-8 with BOM”）→ 选“Save with Encoding” → 选择UTF-8（注意：不是“UTF-8 with BOM”）
- 用 Notepad++：菜单栏“编码”→“转为 UTF-8 无 BOM 格式”→ 再保存
- 命令行快速检测（Linux/macOS）：
file -i translations/messages.zh_CN.yml，输出含charset=utf-8即可；若含bom或charset=unknown-8bit，说明有问题
YAML 文件的中文处理要点
YAML 对非 ASCII 字符更敏感，即使编码正确，未加引号也可能被误解析为控制字符或触发解析器警告。
- 所有含中文、空格、冒号、井号、短横的翻译值，务必用双引号包裹：
button.save: "保存"，而非button.save: 保存 - 避免在 key 中使用中文（如
欢迎消息: "Hello"），key 应保持英文+下划线，符合 Symfony 命名习惯和 Twig 模板调用一致性 - 缩进必须用空格（不能用 Tab），层级对齐要严格，否则
lint:translations会报错
验证与快速排障
别靠刷新网页猜问题——Symfony 遇到编码错误时，trans() 往往直接返回原文或空字符串，不报异常，极难定位。
- 运行校验命令：
php bin/console lint:translations --locale=zh_CN，它会明确指出哪一行存在编码或语法问题 - 清空缓存再试：
php bin/console cache:clear --env=dev（开发环境）或--env=prod（生产环境），避免旧缓存干扰 - 临时启用 strict_mode（在
config/packages/translation.yaml中加strict_mode: true），让缺失/解析失败的翻译直接抛出异常，暴露真实位置
CI/CD 和团队协作建议
单人开发容易手动修好，但多人协作时，不同编辑器默认行为差异会导致反复出错。
- 在项目根目录添加
.editorconfig，强制统一编码和换行：charset = utf-8、end_of_line = lf、insert_final_newline = true - Git 提交前用 pre-commit hook 自动检查（如
pre-commit.com+check-yaml+end-of-file-fixer） - CI 流程中加入
lint:translations步骤，失败即阻断合并
