RStudio knit报错：mutate_无适用于class为function对象的方法，本地运行正常

问题成因 #

• 核心原因是变量命名与R内置对象冲突：R存在内置函数data()，本地交互式运行时你已提前给data变量赋值为数据框，代码可正常执行；但knit会启动独立的干净R会话，若该mutate代码运行前未完成data变量赋值，data会被识别为data()函数，对函数对象执行mutate操作会触发类不匹配报错。
• 次要原因为包加载冲突：若代码同时加载plyr和dplyr包，两者均包含mutate方法，knit时加载顺序与本地环境不一致的情况下，plyr的mutate会覆盖dplyr的mutate，也可能触发该报错。

解决方案 #

• 更换变量名避免命名冲突：不要使用R内置关键字/函数名作为变量名，将数据集变量名从data替换为raw_data、df等无冲突名称，修改后代码示例：

raw_data <- raw_data %>% 
  mutate(
    variable = factor(variable,ordered = FALSE)
  )

• 检查代码块执行顺序：确认notebook中数据导入、预处理的代码块在上述mutate代码块之前，且未设置eval=FALSE参数，保证knit运行到对应代码时数据集已完成赋值。
• 明确指定方法所属包：存在包冲突时，调用mutate时明确指定dplyr包，避免方法被覆盖：

data <- data %>% 
  dplyr::mutate(
    variable = factor(variable,ordered = FALSE)
  )

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