使用Rcpp::sourceCpp时出现未定义符号(_Z1xv)错误的技术问询

问题重现 #

你当前的代码结构包含三个文件：

• header.h

#include <Rcpp.h>
int x();

• def.cpp（包含x()的实现）

#include <Rcpp.h>
#include "header.h"
// [[Rcpp::export]]
int x() {
 return 0;
}

• call.cpp（调用x()的函数）

#include <Rcpp.h>
#include "header.h"
// [[Rcpp::export]]
int callx(){
 return x();
}

通过R CMD INSTALL编译整个包后，R中可以正常调用callx()和x()：

R> callx()
[1] 0
R> x()
[1] 0

但单独用Rcpp::sourceCpp()编译call.cpp时，出现链接错误：

> Rcpp::sourceCpp('src/call.cpp')
Error in dyn.load(...) : 
  unable to load shared object ...: undefined symbol: _Z1xv

R CMD INSTALL的编译步骤（自动处理所有文件）：

g++ -I/usr/share/R/include -DNDEBUG -I"/usr/lib/R/library/Rcpp/include" -fpic -g -O2 -fstack-protector-strong -Wformat -Werror=format-security -Wdate-time -D_FORTIFY_SOURCE=2 -g -c RcppExports.cpp -o RcppExports.o
g++ -I/usr/share/R/include -DNDEBUG -I"/usr/lib/R/library/Rcpp/include" -fpic -g -O2 -fstack-protector-strong -Wformat -Werror=format-security -Wdate-time -D_FORTIFY_SOURCE=2 -g -c call.cpp -o call.o
g++ -I/usr/share/R/include -DNDEBUG -I"/usr/lib/R/library/Rcpp/include" -fpic -g -O2 -fstack-protector-strong -Wformat -Werror=format-security -Wdate-time -D_FORTIFY_SOURCE=2 -g -c def.cpp -o def.o
g++ -shared -L/usr/lib/R/lib -Wl,-Bsymbolic-functions -Wl,-z,relro -o linkingtest.so RcppExports.o call.o def.o -L/usr/lib/R/lib -lR

问题原因 #

Rcpp::sourceCpp()默认只编译你指定的单个文件（这里是call.cpp），但call.cpp里调用的x()函数的实现不在这个文件里，而是在def.cpp中。编译链接阶段找不到x()的定义，就会抛出「未定义符号」的错误。

而R CMD INSTALL是针对整个R包的构建流程，它会自动收集所有在包目录下的.cpp文件，编译成目标文件后再统一链接，所以能找到x()的实现，运行正常。

解决方案 #

这里有几个可行的解决办法，根据你的使用场景选择：

1. 用sourceCpp指定所有依赖文件

如果你只是想快速测试代码，不想构建整个包，可以把所有相关的.cpp文件都传给sourceCpp，这样它会编译所有文件并正确链接：

Rcpp::sourceCpp(c('src/def.cpp', 'src/call.cpp'))

执行后就能正常调用callx()和x()了。

2. 把函数实现内联到头文件

如果x()是一个简单的工具函数，可以把它的实现直接放到header.h中，用inline关键字标记，这样包含头文件的地方就能直接获取到函数实现，不需要依赖其他.cpp文件：
修改header.h：

#include <Rcpp.h>
inline int x() {
  return 0;
}

之后单独编译call.cpp就不会报错了。

3. 坚持使用包构建流程（推荐）

如果你是在开发一个R包，最规范的方式还是用R CMD INSTALL或者devtools::install()来构建整个包。这种方式会自动处理多文件的依赖和链接，还能帮你生成RcppExports.cpp等必要文件，更适合长期维护的项目。

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