用 Node.js 在树莓派上驱动 I2C LCD这事听起来像“用 JavaScript 干单片机活”。但说实话Node.js 做硬件控制的异步事件模型比 Python 轮询更顺手尤其在需要同时处理 Web 请求、定时刷新和传感器上报的场景下。这次我们直接看一套可落地的方案树莓派 4B/5 PCF8574 I2C 转接板 LCD1602/LCD2004从接线、开 I2C、装 Node.js到写驱动、跑通显示最后通过 HTTP 接口远程往屏幕上推文字。阅读完你会得到一份可以在树莓派上直接运行的 Node.js 驱动模板以及一套排查 I2C 设备检测失败、地址不对、乱码、背光不亮等问题的标准思路。硬件编程最花时间的不是写代码而是总线不通和时序不对。这次我们把容易踩的坑一并说清楚。1. 核心能力速览能力项说明硬件平台树莓派 4B / 5 或其他带 I2C 总线的 Linux 开发板通信协议I2C常见设备地址 0x27 或 0x3F显示模块LCD1602 / LCD2004 PCF8574 I2C 转接板编程语言Node.js推荐 LTS 版本如 18/20依赖模块i2c-bus基于文件系统 /dev/i2c-1 访问总线异步能力基于 async/await 的异步驱动非阻塞读写 I2C扩展接口可用 Node.js http 模块提供 Web API远程写入显示内容适用场景系统状态展示、内网信息屏、传感器数值显示、IoT 教学是否支持批量任务可在主进程中排队处理多条显示任务防止 I2C 写冲突从实践角度看这个方案的门槛比较友好不需要额外购买 USB 转 I2C 调试器树莓派 GPIO 自带 I2C 控制器软件层面只需要 Node.js 和 i2c-bus 一个模块如果只是点亮屏幕显示固定文字总代码量可以控制在 200 行以内。2. 适用场景与使用边界哪些人适合用 Node.js 控制 LCD首先是前端或 Node.js 后端工程师想进入硬件领域又不想重新学 C/Python其次是已经在树莓派上跑 Node.js 服务的人希望把服务运行状态直接显示在屏幕再就是做教学演示需要把 I2C、Linux 设备文件和异步事件模型串起来讲。这套方案适合做这几类事情把树莓派的 IP、CPU 温度、内存占用定时显示在 LCD 上。内网环境下通过 HTTP 接口把消息推送到 LCD。读取温湿度传感器后把数值同步显示到屏幕。在 Node.js 的 Electron/Web 项目中增加一块物理状态面板。但它不适合做以下场景需要显示图片、复杂波形或大型中文点阵界面的场景建议换用 SPI 接口的彩色屏或 HDMI 显示屏。对毫秒级时序响应要求极高的场景Node.js 的事件循环调度不如 C 语言直接但 LCD1602 本身对微秒级指令延时不算苛刻。需要脱离 Linux 运行的裸机 MCU 环境Node.js 这里依赖树莓派的 Linux 系统和 /dev/i2c 设备文件不能直接运行在 STM32/51 上。合规方面需要留意一点如果你采集的是真实用户信息并显示在公共屏幕上要确认已获得相关人员授权用于公司监控屏或产品展示时确保信息内容合规不泄露内部敏感数据。硬件接线也要避免在树莓派通电状态下插拔杜邦线防止损坏 GPIO 或 I2C 转接板。3. 树莓派 Node.js I2C LCD 的环境准备先列硬件清单。硬件规格说明树莓派4B 起步树莓派 5 同样适用需联网安装系统LCD 模块LCD16022 行 16 列或 LCD20044 行 20 列I2C 转接板PCF8574模块背面可见 8 位扩展芯片杜邦线母对母 4 根VCC、GND、SDA、SCLmicroSD 卡16GB 以上系统推荐 Raspberry Pi OS LitePCF8574 模块常被直接焊接在 LCD 背面只留 4 个引脚出来这样做的好处是省掉大量 GPIO 连线LCD 的 D0-D7、RS、RW、E 都不需要单独处理。接线方式固定LCD I2C 模块引脚树莓派 GPIOVCC物理引脚 25V或物理引脚 45VGND物理引脚 6GNDSDA物理引脚 3GPIO2SCL物理引脚 5GPIO3如果使用树莓派 540Pin 引脚定义与 4B 物理兼容I2C1 仍然是物理引脚 3 和 5。注意部分 LCD 模块背光需要 5V如果接 3.3V屏幕可能有显示但背光偏暗。系统选择上推荐使用 Raspberry Pi OS Lite无桌面版或 Ubuntu Server。装好系统后先做两件事第一更新软件源第二启用 I2C 内核驱动。如果觉得官方源比较慢编辑/etc/apt/sources.list和/etc/apt/sources.list.d/raspi.list替换为国内镜像源。以清华源为例如果你是树莓派 5 跑 Ubuntu 22.04镜像源里面的$RELEASE变量会被正确替换为jammy所以只需先备份原文件再写入以下内容。需要注意的是Raspberry Pi OS 源自带/etc/apt/sources.list.d/raspi.list两者要同时处理。# 备份原文件 sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak sudo cp /etc/apt/sources.list.d/raspi.list /etc/apt/sources.list.d/raspi.list.bak随后编辑源文件把http://raspbian.raspberrypi.org/raspbian/之类地址替换为# /etc/apt/sources.list 示例基于 Raspberry Pi OS deb http://mirrors.tuna.tsinghua.edu.cn/raspbian/raspbian/ bullseye main contrib non-free rpi替换完先运行sudo apt update确认没有报错再继续。镜像站点的路径以你实际打开为准不同系统版本代号不同不要照抄 bullseye 就完事。启用 I2C 有两种方式。有桌面环境时在raspi-config的 Interface Options 中打开 I2C无桌面环境时这样做sudo raspi-config进入 Interface Options选择 I2CEnable。然后检查内核模块。sudo apt install -y i2c-tools ls /dev/i2c-*正常会看到/dev/i2c-1。如果看不到编辑/boot/config.txt树莓派 5 可能是/boot/firmware/config.txt确认存在dtparami2c_armon。接下来安装 Node.js。Raspberry Pi OS 官方源内的 Node.js 版本可能偏旧可以直接使用 NodeSource 安装 LTS 版本或者从 nodejs.org 下载适用于 ARM64 的 Linux 二进制包。这里以 NodeSource 方式为例curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt install -y nodejs node -v npm -v如果在内网环境无法访问 NodeSource可以手动下载node-v20.x.x-linux-arm64.tar.xz后解压到/usr/local。树莓派 4B/5 都是 64 位系统不要下错成 armv7l 版本。安装编译依赖。i2c-bus 模块在安装时会通过 node-gyp 编译原生扩展需要系统有 Python3、make 和 gsudo apt install -y python3 make g到这里环境准备已完成。建议先在终端执行node -e console.log(ok)验证 Node.js 可运行再继续后面的驱动开发。4. I2C 设备地址检测与总线确认LCD 接好线、系统启用 I2C 后第一件事不是写代码而是扫描总线确认树莓派是否真的识别到这个设备。i2cdetect -y 1参数-y表示跳过交互确认1代表 I2C 总线编号 1。执行后终端会打印一个地址表其中出现27或3f就说明找到了 PCF8574 转接板。多数常见模块默认地址是 0x27部分 0x3F也有一些转接板通过板载 A0/A1/A2 跳线改变地址。如果扫描不到任何设备大概率是硬件连线问题而不是 Node.js 代码问题。排查顺序如下1. VCC 是否接 5VGND 是否共地。 2. SDA 和 SCL 是否接反。 3. 杜邦线是否松动。 4. 树莓派 I2C 是否真的启用运行 ls /dev/i2c-*。 5. 转接板是否损坏可换一个模块测试。地址检测成功后可以用i2cdump -y 1 0x27查看总线数据但要注意读取 LCD 模块寄存器意义不大PCF8574 只是把 I2C 数据转成 8 位并行电平真正的“内存映射”在 LCD 控制器 HD44780 内部不是普通 EEPROM 那样直接可读。有些 I2C 模块要求外接上拉电阻树莓派 GPIO 内部已经为 I2C1 启用了 1.8kΩ 上拉所以无需额外上拉如果是自己用杜邦线外接一个独立 PCF8574 芯片则需要检查模块是否带 4.7kΩ 到 10kΩ 上拉电阻。4*4 键盘场景中经常讨论上拉电阻问题本质相同I2C 总线是开漏结构必须有上拉才能保证高电平有效。原装 I2C LCD 转接板基本都带电阻不需要再处理。5. Node.js 项目初始化与依赖安装用 mkdir 创建独立项目目录防止依赖污染系统目录。mkdir ~/lcd-node cd ~/lcd-node npm init -y npm install i2c-bus安装成功后node_modules/i2c-bus内会包含编译好的.node原生扩展可以简单验证模块能被 require。node -e const i2c require(i2c-bus); console.log(typeof i2c.openPromisified)输出function即可。下面使用openPromisifiedAPI把 I2C 读写封装成 Promise这样就不用陷入回调嵌套可以安心写 async/await 逻辑。建议把驱动拆成独立文件lcd.js主程序只负责调用。项目结构如下~/lcd-node/ ├── lcd.js # I2C LCD 驱动类 ├── index.js # 主程序定时显示系统信息 ├── server.js # HTTP API 服务可选 └── package.json6. 编写 I2C LCD 驱动模块PCF8574 转接板的核心原理并不复杂它通过 8 位 I2C 数据引脚模拟 HD44780 的 4 位并行接口。怎么理解PCF8574 的 P0-P7 输出到 LCD 引脚常见映射是P7 - D7 P6 - D6 P5 - D5 P4 - D4 P3 - 背光控制 P2 - E使能 P1 - RW读写选择接地为写 P0 - RS寄存器选择0 为命令1 为数据所以我们向 I2C 总线写入一个字节时实际同时控制了 8 个引脚。写入一个 8 位数据到 LCD需要拆成两个 nibble高 4 位和低 4 位每个 nibble 都要拉高 E 引脚再拉低LCD 在 E 下降沿锁存数据。先看完整驱动代码// lcd.js const i2c require(i2c-bus); const RS 0x01; const RW 0x02; const EN 0x04; const BL 0x08; class Lcd { constructor({ busNumber 1, address 0x27, cols 16, rows 2 } {}) { this.busNumber busNumber; this.address address; this.cols cols; this.rows rows; this.bus null; this.backlight BL; } async init() { this.bus await i2c.openPromisified(this.busNumber); this.bus.writeByte(this.address, 0x33); await this.delay(5); this.bus.writeByte(this.address, 0x32); await this.delay(5); await this.command(0x28); // 4 位模式2 行5x8 点阵 await this.command(0x0C); // 显示开光标关 await this.command(0x06); // 写入后地址自动加 1 await this.command(0x01); // 清屏 await this.delay(2); } delay(ms) { return new Promise(resolve setTimeout(resolve, ms)); } async writeByte(value, mode) { const data (value 0xF0) | mode | this.backlight; await this.bus.writeByte(this.address, data); await this.bus.writeByte(this.address, data | EN); await this.delay(1); await this.bus.writeByte(this.address, data ~EN); const dataLow ((value 4) 0xF0) | mode | this.backlight; await this.bus.writeByte(this.address, dataLow); await this.bus.writeByte(this.address, dataLow | EN); await this.delay(1); await this.bus.writeByte(this.address, dataLow ~EN); } async command(value) { await this.writeByte(value, 0x00); } async print(text) { const chars text.split(); for (const ch of chars) { await this.writeByte(ch.charCodeAt(0), RS); } } async clear() { await this.command(0x01); await this.delay(2); } async home() { await this.command(0x02); await this.delay(2); } async setCursor(col, row) { const rowOffsets [0x00, 0x40, 0x14, 0x54]; const offset rowOffsets[row] || 0x00; await this.command(0x80 | (offset col)); } async displayMessage(line1, line2 ) { await this.clear(); await this.print(line1); if (this.rows 1 line2) { await this.setCursor(0, 1); await this.print(line2); } } } module.exports Lcd;写驱动时最需要注意的是初始化序列。PCF8574 上电后可能处于 8 位模式我们需要先发0x33再发0x32完成“降级”到 4 位模式的过程然后才是常规的0x28、0x0C、0x06、0x01。如果少了 0x33 这一步屏幕可能出现随机乱码或只有第一行正常。7. 功能测试与效果验证写一个最简单的测试文件// test.js const Lcd require(./lcd); async function main() { const lcd new Lcd({ address: 0x27, cols: 16, rows: 2 }); try { await lcd.init(); await lcd.displayMessage(Hello CSDN, Node.js I2C); console.log(LCD display success); } catch (err) { console.error(LCD error:, err); process.exit(1); } finally { setTimeout(async () { await lcd.clear(); process.exit(0); }, 3000); } } main();运行命令node test.js判断成功的标准有三个终端输出LCD display success。LCD 第一行显示Hello CSDN。LCD 第二行显示Node.js I2C且背光正常。如果看到乱码或显示位置不对优先检查address是否与i2cdetect探测结果一致。比如检测结果是 0x3F代码却固定写 0x27那么驱动能读到设备但输出完全不可用。如果想测试滚动显示可以写一段定时器逻辑每 3 秒切换一次行内容模拟动态信息面板。这里要注意每次打印前如果不清屏也不设置光标文字会从上次位置继续往后写超出 16 列的部分不会自动换行到第二行而是被截断。所以在更新整屏信息时最稳妥的做法是先clear()然后setCursor(0, 0)再打印第一行最后跳转到第二行。8. 显示中文问题LCD1602 字库限制与替代方案很多人在树莓派上跑通 LCD 后第一反应就是“我想显示中文”。这里要说清楚普通 LCD1602/LCD2004 内置的 HD44780 字符 ROM 只包含 ASCII 字符、日文假名和少量符号没有中文字库直接把中文字符串按 UTF-8 编码写进去屏幕上会出现乱码。如果必须显示中文有几种常见路径方案说明难度购买带中文字库的 LCD 模块模块内置 GB2312 或 Unicode 字库写入对应编码即可低使用 LCD12864 图形屏将中文字模转成点阵图片逐 bit 写入中树莓派上用 SPI OLED通过占位图方式显示中文每次写整个帧缓冲中高如果你的项目不是把中文字模显示当作核心诉求建议还是沿用 ASCII 显示方案只显示 IP、时间、温度、英文状态。比如 CPU 温度可以显示为CPU 52.3C避免了中文字库的适配成本。如果一定要在 Node.js 里做中文点阵思路是准备一个包含常用汉字的字模数组比如 16x16 点阵每个字 32 字节然后将汉字拆分到 5x8 的自定义字符模式这超出了普通 LCD1602 模块的能力范围。最实用的路线是换用中文字库版 LCD2004数据写入方式和 ASCII 版几乎一致只是字符编码上要发送 GBK 编码而非 UTF-8。在 Node.js 中转换编码可以使用iconv-litenpm install iconv-liteconst iconv require(iconv-lite); const buf iconv.encode(温度 25C, gbk); for (const byte of buf) { await lcd.writeByte(byte, RS); }不过具体模块的字库编码方式需要以硬件说明书为准不要盲目照搬代码。标准 PCF8574 转接板驱动 HD44780 只能处理 ASCII 字符这点可以先接受。9. 系统状态监视与批量显示任务LCD 单独显示一句话意义有限把它变成系统监视屏才有实用价值。树莓派上通过/proc和/sys/class/thermal可以拿到系统信息Node.js 不需要额外安装系统监控库。// monitor.js const fs require(fs); const os require(os); const Lcd require(./lcd); function readCpuTemperature() { try { const raw fs.readFileSync(/sys/class/thermal/thermal_zone0/temp, utf8); return (parseInt(raw, 10) / 1000).toFixed(1); } catch (err) { return N/A; } } function getIPAddress() { const ifaces os.networkInterfaces(); for (const name of Object.keys(ifaces)) { for (const iface of ifaces[name]) { if (iface.family IPv4 !iface.internal) { return iface.address; } } } return 127.0.0.1; } async function main() { const lcd new Lcd({ address: 0x27, cols: 16, rows: 2 }); await lcd.init(); setInterval(async () { const ip getIPAddress(); const temp readCpuTemperature(); const mem os.freemem() / 1024 / 1024; const totalMem os.totalmem() / 1024 / 1024; const memPercent ((1 - mem / totalMem) * 100).toFixed(0); await lcd.displayMessage(IP ${ip}, Mem ${memPercent}% T${temp}C); }, 5000); } main().catch(err { console.error(err); process.exit(1); });运行node monitor.js后LCD 会每 5 秒刷新一次。这里会遇到硬件编程常见的“写冲突”问题如果下一次 setInterval 触发时上一次异步写入还没结束两条消息交错发给 LCD屏幕内容会错乱。虽然在上述代码中 5 秒间隔足够长但在真实项目中可能同时存在 Web 接口写入、传感器事件写入、定时刷新三条路径所以需要一个显示任务队列。批量任务可以用最简单的方式实现主程序只负责入队驱动内部串行执行显示任务。class LcdQueue { constructor(lcd) { this.lcd lcd; this.queue []; this.running false; } push(line1, line2 ) { this.queue.push({ line1, line2 }); this.process(); } async process() { if (this.running || this.queue.length 0) return; this.running true; while (this.queue.length 0) { const task this.queue.shift(); try { await this.lcd.displayMessage(task.line1, task.line2); } catch (err) { console.error(display error:, err); } await this.lcd.delay(300); } this.running false; } } module.exports LcdQueue;这套队列的思想很简单任何上游任务都先把内容推到队列显示进程循环取出并执行避免多个异步写入同时操作 I2C 总线。它不需要 redis 或消息队列小项目中一个数组足够。类似“闪屏”“重叠文字”大部分情况下都是因为没有全局串行化显示写入。10. 通过 HTTP API 远程控制 LCD树莓派作为常开的低功耗服务器最适合做的就是把 LCD 变成一个可远程控制的物理信息屏。这里用 Node.js 内置http模块提供接口不需要引入 Express 依赖。// server.js const http require(http); const Lcd require(./lcd); const LcdQueue require(./lcdqueue); const lcd new Lcd({ address: 0x27, cols: 16, rows: 2 }); const queue new LcdQueue(lcd); async function main() { await lcd.init(); console.log(LCD initialized); const server http.createServer((req, res) { if (req.method POST req.url /display) { let body ; req.on(data, chunk body chunk); req.on(end, () { try { const parsed JSON.parse(body); const line1 (parsed.line1 || ).slice(0, 16); const line2 (parsed.line2 || ).slice(0, 16); queue.push(line1, line2); res.writeHead(200, { Content-Type: application/json }); res.end(JSON.stringify({ code: 0, message: ok })); } catch (err) { res.writeHead(400, { Content-Type: application/json }); res.end(JSON.stringify({ code: 400, message: invalid json })); } }); return; } res.writeHead(404, { Content-Type: application/json }); res.end(JSON.stringify({ code: 404, message: not found })); }); server.listen(3000, 0.0.0.0, () { console.log(Server listening on port 3000); }); } main().catch(err { console.error(err); process.exit(1); });注意构造函数里我们把 LcdQueue 单独存储在index.js里还要调用一次lcd.init()。上面的代码为了展示写法省略了模块关系正确做法是传入已经完成 init 的 lcd 实例。队列模块本身不管初始化流程。通过curl调用curl -X POST http://127.0.0.1:3000/display \ -H Content-Type: application/json \ -d {line1:Server OK,line2:Port 3000}返回{code:0,message:ok}说明接口调用成功LCD 显示内容会更新。为了避免客户端传入超长内容把屏幕写坏代码里用slice(0, 16)做了截断具体长度要以 LCD 列数为准。第二行截断长度取 16但 LCD2004 是 20 列所以这个参数应该根据 lcd.cols 动态算出。接口调用成功后你可以直接从内网任意机器把消息推到树莓派 LCD 上比如结合 shell 脚本、监控系统 webhook 或一个简单的移动端工具页。11. 资源占用与性能观察树莓派上跑 Node.js 控制 LCD很多人担心性能问题。实际上 Node.js 进程对树莓派 4B 而言非常轻量。通过htop或ps观察一个纯 LCD 服务进程的内存占用通常在 50 MB 以下CPU 占用率基本接近 0。ps aux | grep node观察要点如下Node.js 进程只会在写入 I2C 时短暂占用 CPUI2C 总线速率默认 100 kHz写入几个字节的时间是微秒级对 CPU 影响很小。树莓派使用 Node.js 收发 HTTP 请求时进程会进入事件循环等待不会持续占用 CPU。定时刷新不要设置过短LCD1602 人眼可观察的变化在 200ms 以上没必要 100ms 刷一次。LCD 内部控制器 HD44780 清屏指令需要 1.5ms 左右如果频繁清屏会导致显示闪烁。I2C 总线本身是半双工同一时间只能有一个主设备访问树莓派上不要同时运行多个直接访问 LCD 的进程避免总线 busy 报错。如果代码中连续写入不等待I2C 可能返回EIO或EBUSY错误此时应该在错误处理里重试或增加延时。降低资源占用的有效手段包括批量刷新时只在内容变化时才刷新不要每轮都调用清屏指令改为 setCursor 后覆盖写全屏文本使用 Buffer 拼接再一次性写入减少 JS 字符串到 I2C 字节的转换开销。LCD 刷新本身是低速外设性能瓶颈从来不在树莓派 CPU而在 I2C 总线时钟和 LCD 控制器时序。12. 常见问题与排查方法把实际开发中最常遇到的现象整理成表问题现象可能原因排查方式解决方案i2cdetect 扫描不到设备接线错误、I2C 未启用、模块损坏检查 VCC/GND/SDA/SCL重启后再扫描重新插拔杜邦线执行 sudo raspi-config 启用 I2C屏幕有背光但不显示文字对比度电位器调太低用小螺丝刀旋转 LCD 背面蓝色电位器调到能隐约看到方块再运行显示程序显示乱码初始化时序不对或地址错误检查代码中的 address 与 i2cdetect 结果是否一致确认驱动中的 0x33 初始化序列完整只有第一行正常驱动未正确设置两行模式检查命令 0x28 是否发送成功确认 LCD 是 1602且 rows 参数传 2显示内容残影未清屏直接覆盖写打印前调用 clear 或 home更新内容前先清屏再 setCursorNode.js 报 EIOI2C 总线忙或设备无响应查看 dmesg 是否有 i2c 错误重启树莓派或检查接线npm install i2c-bus 编译失败缺少 python3/make/g查看安装日志尾部错误执行 sudo apt install -y python3 make g屏幕出现闪烁方块背光电压不足或对比度不对检查 VCC 是否接 5V改用 5V 供电不要接 3.3V接口返回 ok 但屏幕没变化队列里还有多条未执行任务检查服务端日志清空队列后重试或重启 node 进程重启后显示服务没起来未配置开机自启查看 pm2 list 或 systemd 状态使用 pm2 或 systemd 配置常驻服务这里特别强调几点排查经验。I2C 设备名字扫描不到先把目光从代码转移到硬件。杜邦线接触不良是树莓派外设场景第一杀手。换线、换引脚、重新插拔比调试代码更有效。屏幕有背光但无字符时优先拧对比度电位器。PCF8574 转接板通常自带一个蓝色电位器出厂位置可能接近最小值导致字符完全隐形此时你以为驱动有问题实际上只是对比度不对。初始化完成后第一次写文字乱码很大原因是 PCF8574 与 LCD 模块中间的排线松动或者转接板本身存在虚焊。可以尝试用手按压排线连接处观察现象。13. 主机上使用 pm2 或 systemd 常驻服务树莓派作为 IoT 网关要让 LCD 服务在重启后自动运行不能每次都手工执行node server.js。推荐使用 pm2 管理 Node.js 进程。sudo npm install -g pm2 cd ~/lcd-node pm2 start server.js --name lcd-server pm2 save pm2 startuppm2 startup会输出一条 root 权限命令复制执行即可设置开机自启。pm2 的核心优点在于进程崩溃后自动重启、日志统一管理、重启后自动拉起来。LCD 驱动在 I2C 设备暂时不可用时可能会抛异常pm2 会自动拉起进程但要注意进程拉起前需要等待 I2C 设备就绪所以代码里最好加上重试初始化逻辑。使用 systemd 也是常见做法创建/etc/systemd/system/lcd.service[Unit] DescriptionLCD Display Service Afternetwork.target [Service] ExecStart/usr/bin/node /home/pi/lcd-node/server.js Restartalways RestartSec5 Userpi [Install] WantedBymulti-user.targetsudo systemctl daemon-reload sudo systemctl enable lcd.service sudo systemctl start lcd.service systemctl status lcd.servicepm2 和 systemd 二选一即可不必同时使用。14. 最佳实践与使用建议从可维护性角度给几条建议。第一把 I2C 设备地址做成环境变量或启动参数不要硬编码。换一块 LCD 模块地址从 0x27 变成 0x3F 时改代码要重新部署而用环境变量只需修改启动命令。LCD_ADDR0x3f node server.js第二每次开机后 I2C 设备并不一定完全就绪驱动 init 前要做错误重试。初始化失败不要直接 process.exit可以延迟 1 秒后重试 5 次确保树莓派启动完成后再初始化 LCD。async function initWithRetry(lcd, retries 5) { for (let i 0; i retries; i) { try { await lcd.init(); return; } catch (err) { console.error(init failed, retry ${i 1}/${retries}); await new Promise(resolve setTimeout(resolve, 1000)); } } throw new Error(LCD init failed after retries); }第三项目里划分 model 和 view传感器读取是 modelLCD 显示是 view中间通过队列解耦。不建议在传感器回调里直接调 lcd 方法这样后续增加接口推送或数据库记录时需要改动底层逻辑。第四真实项目要处理 LCD 字符长度。LCD1602 第一行 16 字符LCD2004 第一行 20 字符字符串要按列数做 padEnd 或 slice。显示不足长度时要用空格清空残余字符否则上一轮内容会残留。第五背光控制要独立抽方法。PCF8574 的 P3 引脚控制背光把背光数据字节与显示数据分离可以在夜间自动关闭背光。驱动里把this.backlight变为可动态修改的字段需要时清除对应位即可。第六国内网络环境下载 Node.js 和 npm 包可能较慢建议设置 npm 镜像npm config set registry https://registry.npmmirror.com这能显著缩短 npm install 时间对树莓派这种硬件环境尤其重要。安装完模块后可以把 registry 改回默认或保留都行看个人偏好。第七所有对外提供的 HTTP API 都应限制访问来源。比如只在 listen 时绑定内网 IP或用简单 token 校验避免局域网内其他设备随意写屏。LCD 虽是低危外设但 API 接口最好保持最基本的安全性。15. 总结与下一步这次带大家从硬件接线一路走到 Node.js 驱动和 HTTP 接口调用核心是四步接通 I2C 总线、用 i2cdetect 找到设备、用 i2c-bus 通过 PCF8574 模拟 HD44780 时序、把 LCD 操作封装成服务。整个链路跑通以后LCD 不再是只能亮一下的“点灯工程”而是一个可以被 Web 请求、传感器事件和定时任务共同驱动的信息输出终端。最值得先验证的功能是驱动初始化建议第一次上手先跑最简单的 Hello World不要直接把队列、Web server、pm2 全部堆上去。变量越少排查越容易。最容易踩的坑是 i2cdetect 扫不到设备通常不是代码问题而是接线问题其次是屏幕有背光但没字通常要调对比度电位器。这两个坑踩完之后再往上叠加复杂功能会更加顺利。下一步可以扩展的方向包括给 LCD 增加按键输入用树莓派 GPIO 做一个菜单选择器把 DHT11 或 BME280 传感器的数据定时显示通过 MQTT 协议订阅消息让其他设备远程推送内容到屏幕或者把显示服务打包成 Docker 镜像利用 docker-compose 统一管理树莓派上的多个服务。如果只是做简单信息展示保留 LCD1602 PCF8574 Node.js 这套组合已经足够稳定便宜如果想做内容更丰富的仪表盘建议考虑 3.5 寸 SPI 屏或 HDMI 触摸屏但相应地功耗和接线复杂度也会上升。按需选择即可。