PyCharm中pyserial与Arduino串口通信报错及代码问题求助

核心报错分析 #

TypeError: Serial() takes no arguments 错误主要由以下两种原因导致：

• 你的Python脚本文件名是serial.py，导入时优先加载了自己的脚本，覆盖了pyserial官方库的Serial类
• pyserial库未正确安装或版本不兼容

报错快速修复步骤 #

1. 检查脚本文件名，绝对不能命名为serial.py，如果是立即改名
2. 卸载重装pyserial确保版本适配：

   pip uninstall serial pyserial
   pip install pyserial
   

Python代码修复（适配Python3+功能逻辑） #

原代码存在Python2语法残留、逻辑缩进错误、串口写入位置错误等问题，修复后代码如下：

import serial

# 初始化串口，COM口根据实际设备调整，波特率与Arduino保持一致
ser = serial.Serial('COM8', 9600, timeout=1)

while True:
    val = input('Enter value (0:LED关, 1:LED开, 2:风扇开, 3:风扇关): ')
    # 只处理有效输入，避免无效指令发送
    if val in ['0', '1', '2', '3']:
        if val == '1':
            print('Led is on')
        elif val == '2':
            print('Fan is on')
        elif val == '3':
            print('Fan is off')
        elif val == '0':
            print('Led is off')
        # Python3中串口写入需传入字节类型，因此转换编码
        ser.write(val.encode('utf-8'))
    else:
        print('无效输入，请输入0/1/2/3')

修复点说明 #

• 替换Python2的raw_input为Python3标准的input()
• 给print语句添加括号，符合Python3语法规范
• 将ser.write(val)移至while循环内部，确保每次输入都能发送指令
• 增加输入校验逻辑，只处理合法指令，避免无效数据发送
• 修正else分支的缩进错误，原代码else与while对齐属于语法错误

Arduino代码修复（修正结构与逻辑错误） #

原代码缺少setup()函数定义、风扇控制引脚逻辑错误，修复后代码如下：

// 定义引脚常量，提高代码可读性与可维护性
const int LED_PIN = 12;
const int FAN_PIN = 11;

void setup() {
  Serial.begin(9600);
  pinMode(LED_PIN, OUTPUT);
  pinMode(FAN_PIN, OUTPUT);
  // 初始化时关闭LED和风扇，确保初始状态正确
  digitalWrite(LED_PIN, LOW);
  digitalWrite(FAN_PIN, LOW);
}

void loop() {
  if (Serial.available() > 0) {
    char cmd = Serial.read();
    switch(cmd) {
      case '0':
        digitalWrite(LED_PIN, LOW);
        break;
      case '1':
        digitalWrite(LED_PIN, HIGH);
        break;
      case '2':
        digitalWrite(FAN_PIN, HIGH);
        break;
      case '3':
        digitalWrite(FAN_PIN, LOW);
        break;
    }
  }
}

修复点说明 #

• 补充完整的void setup()函数结构，原代码的孤立{}属于语法错误
• 修正case '3'的逻辑错误：原代码控制LED引脚（12），改为控制风扇引脚（11）
• 移除不必要的delay(1000)，避免串口响应延迟
• 初始化时默认关闭LED和风扇，保证设备上电状态一致

测试注意事项 #

1. 上传Arduino代码后，关闭Arduino IDE的串口监视器（避免串口被占用）
2. 在PyCharm中运行修复后的Python脚本，输入0/1/2/3测试功能
3. 如果仍无法连接串口，检查设备管理器中的Arduino COM口编号，修改Python代码中的'COM8'为实际编号

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