为何Rcpp::compileAttributes()会重写NAMESPACE文件？

Rcpp.package.skeleton() 生成的初始 NAMESPACE 只是最小可用模板，compileAttributes() 对其重写是 Rcpp 工具链的预设设计，核心目的是自动同步C++代码和R包的导出/导入规则，避免手动维护的不一致问题，具体原因可分为三类：

• 自动同步Rcpp导出函数列表
  工具会扫描包内所有 src/ 目录下的C/C源文件，识别所有带 // [[Rcpp::export]] 标记的函数，自动将这些函数名写入 NAMESPACE 的 export() 指令中，确保C函数可以直接在R端被调用。只要当前C++代码里的导出函数和NAMESPACE中的现有导出列表不一致，工具就会直接重写该部分内容，不需要手动修改。
• 保证动态库加载声明合规
  R包调用内部编译的C++动态库必须在NAMESPACE中声明正确的 useDynLib() 规则，compileAttributes() 会根据包名、编译配置自动生成符合Rcpp要求的声明，包括自动添加 .registration = TRUE 等必要参数，避免手动修改错误导致的动态库加载失败问题。
• 自动维护Rcpp依赖导入规则
  Rcpp生成的C接口运行时依赖一系列R侧的基础函数，compileAttributes() 会自动在NAMESPACE中添加对应的 importFrom(Rcpp, ...) 类声明，不需要开发者手动维护Rcpp相关的依赖导入，避免漏加导入导致的C函数运行报错。

若需要保留手动添加的自定义NAMESPACE规则，可以将自定义内容放在自动生成标记的上方，或者统一使用roxygen2标签管理全量NAMESPACE内容，即可避免自定义规则被覆盖。

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