genhtml在Linux环境报错cannot read文件，Windows可正常运行如何解决？

原因1：路径大小写不匹配 #

Linux文件系统大小写敏感，Windows大小写不敏感。请核对cov.info文件中SF字段的路径大小写，与实际文件系统中的路径大小写是否完全一致，单字符大小写差异就会导致Linux判定文件不存在。

原因2：父目录权限不足 #

仅给目标文件设置777权限不足以保证访问，路径上所有父目录（如/absolute/path/、/absolute/path/files/等）都需要具备可执行（x）权限，才能让执行genhtml的用户访问到目录内的文件。可执行namei -l /absolute/path/files/file.py逐级检查所有上层目录的权限配置。

原因3：genhtml版本存在bug #

旧版本genhtml存在路径解析的已知问题，处理长路径、带特殊字符的路径时容易出现读取失败。可执行genhtml --version查看当前版本，建议升级到lcov 1.15及以上版本后重试。

原因4：路径包含不可见字符或软链接 #

如果cov.info中的SF路径是软链接路径，或者包含换行、空格等不可见转义字符，也会触发读取错误。可执行cat -A out/cov.info | grep SF:检查路径是否存在额外不可见字符，同时确认路径为实际物理路径而非软链接，替换为真实路径后重试。

临时规避方案 #

如果上述排查均无结果，可以在执行genhtml时添加参数强制指定路径规则：

• 使用--prefix参数移除路径前缀：

genhtml out/cov.info -o out/temp --prefix /absolute/path/files/

• 使用--base-directory参数指定源文件根目录，强制genhtml从指定目录查找文件：

genhtml out/cov.info -o out/temp --base-directory /absolute/path/files/

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