Ruby解析Jekyll项目单个文件YAML前置元数据时遇语法错误

针对你遇到的YAML.load_file(stringForFilePath, permitted_classes: ['Date'])解析单个文件时报control characters are not allowed at line 1 column 1 (Psych::SyntaxError)的问题，在已做排查的基础上，可以试试以下方案：

• 检查文件开头的不可见控制字符：即便编码是UTF-8，文件开头可能存在BOM（字节顺序标记）或\x00、\x01这类不可见字符。可以用命令行工具查看：
  • Linux/macOS：执行cat -A 你的文件名，查看开头是否有^@之类的异常标记
  • Windows：在PowerShell中执行Get-Content 你的文件名 -Raw | Format-Hex，检查前几个字节是否异常
    找到后直接删除这些不可见字符即可。
• 重新创建文件：将原文件内容复制到一个全新创建的纯文本文件中，按相同的UTF-8编码和CRLF行尾格式保存后重试，避免原文件的底层元数据问题。
• 验证文件读取路径：确认stringForFilePath变量没有隐藏转义字符，比如路径中的空格、特殊字符是否被正确处理，直接用绝对路径替换变量测试。
• 用Psych低级别方法调试：通过读取文件内容并检查字节，精准定位异常：

  content = File.read(stringForFilePath)
  # 打印前10个字节查看是否有异常
  puts "文件开头10个字节: #{content.bytes.take(10).inspect}"
  begin
    # 用parse_stream尝试解析，获取更详细错误
    Psych.parse_stream(content)
  rescue Psych::SyntaxError => e
    puts "详细错误信息: #{e.message}"
  end
  

• 切换纯文本编辑器保存：避免使用带有自动格式的编辑器，改用Notepad++、VS Code纯文本模式重新保存文件，防止编辑器插入不可见格式字符。

内容的提问来源于stack exchange，提问作者user1086516