1，安裝依賴
確保已經(jīng)安裝 pyserial：

pip3 install pyserial

如果無(wú)法用pip3安裝，那就創(chuàng)建一個(gè)虛擬環(huán)境進(jìn)行安裝

如果你想安裝最新版本的 pyserial 或其它非 Debian 打包的庫(kù)，建議在用戶目錄下創(chuàng)建一個(gè)虛擬環(huán)境：

安裝完整的 Python3（如果尚未安裝）
sudo apt update
sudo apt install python3-full python3-venv
在你的項(xiàng)目目錄創(chuàng)建并激活 venv

cd ~/myproject
python3 -m venv venv
source venv/bin/activate
然后就可以在虛擬環(huán)境中用 pip 安裝

pip install pyserial
運(yùn)行腳本時(shí)，確保虛擬環(huán)境已激活（(venv) 出現(xiàn)在命令行提示符），這樣 import serial 就能找到你通過(guò) pip 安裝的包。

若要退出虛擬環(huán)境，執(zhí)行

deactivate

2，啟用串口

在樹莓派上執(zhí)行 sudo raspi-config，進(jìn)入 Interface Options → Serial Port，

“Would you like a login shell to be accessible over serial?” 選擇 No

“Would you like the serial port hardware to be enabled?” 選擇 Yes
重啟后，串口 /dev/serial0 就可用了。

特別注意，如果還是不能用，多半是映射錯(cuò)誤：

串口未啟用或映射錯(cuò)誤
在 Raspberry Pi 5 上，/dev/serial0 默認(rèn)是否真正映射到了 UART0，要確認(rèn)。

請(qǐng)先確認(rèn) /boot/firmware/config.txt 中是否有以下配置（最重要的）：

enable_uart=1
dtoverlay=uart0

然后執(zhí)行：

ls -l /dev/serial0

你應(yīng)看到：

serial0 -> ttyAMA0

特別注意：樹莓派5的uart0引腳是GPIO14(TXD),GPIO15(RXD)

3，做好上面配置后，借鑒以下代碼即可進(jìn)行樹莓派5的串口通信

#!/usr/bin/env python3
# -*- coding: utf-8 -*-import serial
import timedef main():# 串口設(shè)備名稱，樹莓派 5 上 /dev/serial0 通常會(huì)映射到 UART0port = '/dev/serial0'# 波特率（根據(jù)需要修改，常用 9600、115200 等）baudrate = 115200# 打開串口try:ser = serial.Serial(port=port,baudrate=baudrate,bytesize=serial.EIGHTBITS,parity=serial.PARITY_NONE,stopbits=serial.STOPBITS_ONE,timeout=1)  # 讀取超時(shí) 1 秒except serial.SerialException as e:print(f"無(wú)法打開串口 {port}: {e}")returnprint(f"串口 {port} 已打開，波特率 {baudrate}")try:while True:# 要發(fā)送的字符串msg = "hello word?"# 注意要發(fā)送 bytes，末尾可加 \r\n 根據(jù)接收端需求ser.write(msg.encode('utf-8') + b'\r\n')print(f"已發(fā)送: {msg}")# 讀取接收緩存中的所有數(shù)據(jù)incoming = ser.readline().decode('utf-8', errors='ignore').strip()if incoming:print(f"接收到: {incoming}")# 每隔 1 秒發(fā)送一次time.sleep(1)except KeyboardInterrupt:print("\n檢測(cè)到 Ctrl+C，中斷程序。")finally:ser.close()print("串口已關(guān)閉。")if __name__ == '__main__':main()