license-eye：模式替换未生效，新许可证头追加而非替换求助

我正尝试改写当前项目的许可证头，使其仅包含版权信息、年份、项目所有者，以及对应许可证的SPDX引用。据我理解，我可以将原许可证内容作为匹配模式，用新内容替换它，但该操作似乎未生效。执行fix操作后，新的许可证头被追加到旧头之后，而非替换旧头。

我的当前YAML配置如下：

content: |
    Copyright (c) [year] [owner]

    SPDX-License-IDENTIFIER: AGPL-3.0-or-later

pattern: |
    Copyright (C) [year] [owner]

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU Affero General Public License as
    published by the Free Software Foundation, either version 3 of the
    License, or (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
    GNU Affero General Public License for more details.

    You should have received a copy of the GNU Affero General Public License
    along with this program. If not, see <http://www.gnu.org/licenses/>.

请问是该功能尚未实现，还是我的YAML配置存在错误？

这种情况大概率是你的YAML配置存在匹配问题，而非功能未实现。以下是关键问题点和修复方案：

• 正则匹配精确性不足
  多数许可证头工具会将pattern解析为正则表达式，你当前用的原始文本匹配会因为空格、换行、特殊字符（比如括号、句点）导致匹配失败，工具找不到旧许可证头，只能直接追加新内容。
  修复方案：将pattern改为正则兼容格式，转义特殊字符，用\s*匹配任意空白（包含换行和空格）。示例修正后的pattern：

  pattern: |
      Copyright \(C\) \[year\] \[owner\]\s*
      This program is free software: you can redistribute it and/or modify\s*
      it under the terms of the GNU Affero General Public License as\s*
      published by the Free Software Foundation, either version 3 of the\s*
      License, or \(at your option\) any later version\.\s*
      This program is distributed in the hope that it will be useful,\s*
      but WITHOUT ANY WARRANTY; without even the implied warranty of\s*
      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE\. See the\s*
      GNU Affero General Public License for more details\.\s*
      You should have received a copy of the GNU Affero General Public License\s*
      along with this program\. If not, see <http://www\.gnu\.org/licenses/>\.
  

• 遗漏注释符号匹配
  如果你的旧许可证头是包裹在注释标签里的（比如Python的#、Java的/* */），但pattern里没包含这些符号，工具会无法匹配到目标内容。
  修复方案：检查目标文件中旧许可证头的实际格式，把注释符号加入到pattern中。比如Python文件的注释格式：

  pattern: |
      # Copyright \(C\) \[year\] \[owner\]
      #
      # This program is free software: you can redistribute it and/or modify
      # it under the terms of the GNU Affero General Public License as
      # published by the Free Software Foundation, either version 3 of the
      # License, or (at your option) any later version.
      # ...（后续每行都加上#前缀）
  

• 换行符与空白不一致
  不同系统的换行符（\n vs \r\n）可能导致文本匹配失败，建议用\s*替代固定换行，确保匹配任意空白组合。

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