Linux下DEB包中编程示例文件的合适存放路径咨询

• 首选路径：/usr/share/doc/myprogram/examples/
  这完全符合Linux文件系统层级规范（FHS）和Debian打包惯例，编程示例属于程序配套文档的一部分，和你已经规划的通用文档目录/usr/share/doc/myprogram/归属一致，用examples子目录单独归类，既清晰又符合社区约定。

• 特殊场景的可选路径：

  • 如果你的API示例是需要被开发工具自动扫描识别的资源（比如某些语言的SDK示例），可以考虑放在/usr/share/myprogram/examples/，但这个路径更偏向程序专属的共享资源，而非文档类内容，优先推荐前者。
  • 若示例包含可编译运行的代码，可在该目录下附带Makefile或编译脚本，方便用户直接测试。

• 避坑提醒：

  • 绝对不要将示例文件放在/usr/bin/或/etc/目录下，这两个目录分别对应二进制执行文件和配置文件，与示例文档的用途完全不符。
  • 打包时需设置正确的文件权限：示例文件权限建议设为644，目录权限设为755，确保普通用户可正常读取。

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