MicroPython复用多参数重载方法报错？原因及实现方案

我在树莓派Pico的MicroPython环境中编写了Lcd类，初始化代码如下：

class Lcd:
    def __init__(self, width, height, channel, sdaPin, sclPin, contrast):
        from time import sleep
        from machine import Pin, I2C
        from ssd1306 import SSD1306_I2C
        self.contrast = contrast
        self.sleep = sleep
        self.width = width
        self.height = height
        self.channel = channel
        self.i2cLCD = I2C(self.channel, sda=Pin(sdaPin), scl=Pin(sclPin), freq=400000)
        self.dsp=SSD1306_I2C(self.width,self.height,self.i2cLCD)

主程序中初始化对象：

lcd = Lcd(128,64,1,26, 27, 1)

我习惯Java的方法重载写法，例如：

double calculateBalance(double income, double expenses){
        return income - expenses;
    }
    
    double calculateBalance(){
        return this.calculateBalance(100, 80); // 仅为示例默认参数
    }

但在Lcd类中尝试定义两个text方法时：

def text(self, txt, startXPx, startYPx , colsCount, rowsCount, dsp):
        # LCD显示文本的逻辑
        self.dsp.show()
    
def text(self, txt):
        # 调用带默认参数的重载方法
        self.text( txt, 0, 0, self.width/8, self.height/10, 1)

调用lcd.text('my text')时出现报错：

MPY: soft reboot
Traceback (most recent call last):
  File "<stdin>", line 60, in <module>
  File "<stdin>", line 50, in text
TypeError: function takes 2 positional arguments but 7 were given

请问：

1. 该报错的原因是什么？
2. 如何在MicroPython中实现类似Java的方法重载效果，复用多参数方法？

报错原因 #

Python（包括MicroPython）不支持方法重载。当你在类中定义两个同名的text方法时，后定义的方法会直接覆盖前一个。此时类中实际只有最后定义的def text(self, txt):这一个方法。

当你在这个方法内部调用self.text(txt, 0, 0, self.width/8, self.height/10, 1)时，本质是在调用这个仅接受2个位置参数（self和txt）的方法，但你传入了6个额外参数（加上self一共7个），因此触发TypeError，提示参数数量不匹配。

实现类似重载的方案 #

方案1：使用默认参数（推荐） #

直接在同一个方法中为可选参数设置默认值，既支持全参数调用，也支持简化调用，自动使用默认值，同时复用同一套逻辑：

def text(self, txt, startXPx=0, startYPx=0, colsCount=None, rowsCount=None, dsp=1):
    # 处理依赖实例属性的默认值
    if colsCount is None:
        colsCount = self.width / 8
    if rowsCount is None:
        rowsCount = self.height / 10
        
    # 这里编写LCD显示文本的逻辑
    self.dsp.show()

调用方式：

• 简化调用：lcd.text('my text')（自动使用所有默认参数）
• 自定义参数：lcd.text('custom text', 10, 20, 16, 6, 1)

方案2：使用可变参数*args #

如果需要更灵活的参数处理，可以用*args接收可变数量的参数，再根据参数数量分支处理：

def text(self, txt, *args):
    # 初始化默认参数
    startXPx = 0
    startYPx = 0
    colsCount = self.width / 8
    rowsCount = self.height / 10
    dsp = 1
    
    # 根据传入的参数数量覆盖默认值
    if len(args) >= 1:
        startXPx = args[0]
    if len(args) >= 2:
        startYPx = args[1]
    if len(args) >= 3:
        colsCount = args[2]
    if len(args) >= 4:
        rowsCount = args[3]
    if len(args) >= 5:
        dsp = args[4]
        
    # 这里编写LCD显示文本的逻辑
    self.dsp.show()

这种方式调用体验接近重载，但代码可读性不如默认参数，适合参数数量变化较多的场景。

方案3：使用不同方法名（最直接） #

如果不想处理复杂的参数逻辑，可以直接定义两个不同名的方法，明确区分调用方式：

def text_full(self, txt, startXPx, startYPx , colsCount, rowsCount, dsp):
    # LCD显示文本的逻辑
    self.dsp.show()
    
def text(self, txt):
    self.text_full(txt, 0, 0, self.width/8, self.height/10, 1)

这种方式逻辑清晰无歧义，适合简单场景。

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