移至Filr（Micro Focus）后Sphinx构建文档提示找不到源目录求助

将项目迁移至Micro Focus Filr备份系统后，Sphinx无法构建文档，在桌面等其他位置存放时则能正常运行。已仔细检查路径和文件名无误，Filr支持自动同步且可离线访问。

执行的命令：

cd "C:\Users\antdu953\Filr\My Files\WAVE ENERGY\RESEARCH\MODELLING\xModel\docs"
make html

报错信息：

Application error:
Cannot find source directory (C:\Users\antdu953\Filr\My Files\WAVE ENERGY\RESEARCH\MODELLING\xModel\docs\source)

可能的原因分析 #

• Filr同步不完整：Filr的离线访问依赖本地缓存，可能docs/source目录未完全同步到本地。手动触发Filr客户端的强制同步，或检查同步状态确认该目录已下载完成。

• 路径特殊字符解析异常：路径包含空格（如My Files），部分Windows环境下的命令工具或Sphinx路径解析逻辑可能出错。可以：

  • 将项目复制到无空格的路径下测试；
  • 执行命令时显式指定SOURCEDIR：

    make html SOURCEDIR="C:\Users\antdu953\Filr\My Files\WAVE ENERGY\RESEARCH\MODELLING\xModel\docs\source"
    

• 权限限制：Filr可能对目录设置了特殊权限，导致Sphinx进程无法读取source目录。检查本地文件权限（确保当前用户有读取权限），同时确认Filr端未将该目录设为只读或限制访问。

• 文件系统虚拟化：Filr客户端可能通过虚拟化技术重定向了存储路径，Sphinx解析的路径并非真实本地路径。在文件资源管理器中打开source目录，查看地址栏的真实路径，替换命令中的路径后重试。

• Sphinx配置路径失效：检查docs目录下的Makefile或conf.py，确认其中source目录的路径配置是否正确。迁移后相对路径可能失效，需更新为当前Filr下的正确路径。

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