为何在Computer Craft自定义API中无法使用Peripheral API？

首先明确：完全允许在自定义API中使用外设，调用返回nil的问题几乎都是实现细节出错导致的，以下是核心原因和正确实现方式：

常见问题排查 #

• 外设标识错误：调用peripheral.wrap()时必须传入正确的外设侧方（如"right"、"top"）或外设ID。可以先在控制台执行peripheral.getNames()，打印所有可用外设的标识，确认目标设备的正确名称。
• API加载时机过早：如果API在系统启动阶段（比如startup.lua中提前加载）自动初始化外设，此时硬件可能还未完成连接，导致wrap返回nil。建议在API中提供手动初始化方法，让用户在确认外设连接后再调用。
• 全局模块访问问题：确保API中能访问全局的peripheral模块，不要将其定义为局部变量，否则会导致无法调用外设方法。

正确实现示例 #

以下是一个简化显示器操作的自定义API示例：

monitorAPI.lua 代码 #

local monitor = nil

-- 初始化外设，传入目标外设的侧方/ID
function init(side)
    monitor = peripheral.wrap(side)
    if not monitor then
        error("无法连接到指定外设：" .. side)
    end
    -- 可选：设置默认显示参数
    monitor.setTextScale(0.75)
    monitor.clear()
end

-- 在指定位置写入文本
function writeAt(x, y, content)
    if not monitor then
        error("请先调用 init() 初始化显示器")
    end
    monitor.setCursorPos(x, y)
    monitor.write(tostring(content))
end

-- 清空屏幕
function clear()
    if monitor then
        monitor.clear()
    end
end

-- 重新连接外设
function reconnect(side)
    monitor = peripheral.wrap(side)
end

调用API的示例代码 #

-- 加载API
os.loadAPI("monitorAPI")
-- 初始化右侧的显示器
monitorAPI.init("right")
-- 使用自定义方法
monitorAPI.writeAt(1, 1, "测试文本")
-- 清空屏幕
monitorAPI.clear()

额外注意事项 #

• 每次调用API方法前检查外设实例是否存在，避免nil报错；
• 若支持热插拔外设，可在API中添加重新连接方法，方便用户在设备插拔后恢复功能；
• 测试时可以先在控制台手动调用peripheral.wrap("目标侧方")，确认能正常获取外设实例后再集成到API中。

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