Docker容器中Doxygen无法识别m2cpp.pl过滤器的问题求助

核心问题分析 #

你遇到的两个错误本质都是Windows环境编辑的脚本在Linux容器中的兼容性问题：

• sh: 1 /usr/local/bin/m2cpp.pl: not found：并非真的路径不存在，而是脚本换行符或解释器指定错误导致无法执行
• /usr/bin/perl.exe^M: bad interpreter: No such file or directory：^M是Windows的CRLF换行符，且shebang行指定了Windows版perl路径，Linux容器无法识别

分步解决方案 #

1. 修复脚本换行符格式 #

Windows下编辑的文件默认用CRLF（回车+换行），Linux容器仅识别LF（换行）。执行命令转换：

sed -i 's/\r$//' /usr/local/bin/m2cpp.pl

2. 修正脚本的shebang行 #

打开m2cpp.pl，将第一行的#!/usr/bin/perl.exe改为Linux容器中的perl路径。可先在容器中执行which perl确认路径，通常为/usr/bin/perl，修改后如下：

#!/usr/bin/perl

3. 确保脚本可执行权限 #

重新设置脚本权限：

chmod +x /usr/local/bin/m2cpp.pl

执行/usr/local/bin/m2cpp.pl测试，无报错则说明脚本本身可正常运行。

4. 检查Doxyfile关键配置 #

确保以下配置项正确：

• FILTER_PATTERNS：指定MATLAB文件使用m2cpp.pl过滤，示例：

  FILTER_PATTERNS        = *.m=/usr/local/bin/m2cpp.pl
  

• INPUT：正确指向你的MATLAB源码目录
• FILE_PATTERNS：包含*.m

5. 验证容器perl环境 #

若使用的Doxygen镜像未预装perl，需在BitBucket流水线步骤中先安装：

apt-get update && apt-get install -y perl

测试流程 #

1. 进入交互式容器完成上述修改
2. 手动运行doxygen Doxyfile，观察是否仍有错误提示
3. 检查生成的文档目录，确认内容是否正常生成

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