首次开发R包遇双问题：DESCRIPTION字段错误+函数无输出

1. 修复DESCRIPTION维护者字段错误 #

DESCRIPTION里的Maintainer字段必须严格按**姓名 <邮箱>**的格式编写，不能有任何格式偏差。比如正确写法：

Maintainer: Raymond Castillo <your_email@domain.com>

修改后保存文件，再重新运行devtools::install()或devtools::check()即可。

2. 处理NAMESPACE非roxygen2生成的警告 #

如果之前手动创建过NAMESPACE文件，按以下步骤操作：

• 删除包根目录下的NAMESPACE文件
• 给你的VCF读取函数添加roxygen2注释，至少包含@export标签（确保函数能被外部调用），示例：

#' 读取并格式化VCF文件
#' @param vcf_path VCF文件的本地路径
#' @return 格式化后的VCF数据集（数据框或tibble）
#' @export
read_vcf <- function(vcf_path) {
  # 你的原有脚本代码
}

• 运行devtools::document()，roxygen2会自动生成符合要求的NAMESPACE文件

3. 函数无报错但无输出的问题 #

独立脚本能正常运行但包函数无输出，通常是以下原因导致：

• 函数未显式返回结果：检查函数代码，确保最后一行是你要输出的数据对象，或添加return(你的结果对象)语句
• 测试时未赋值结果：调用函数时需将结果保存到变量中，比如：

# 调用函数并保存结果
vcf_result <- read_vcf("你的测试vcf文件路径.vcf")
# 查看结果
vcf_result

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