如何解决KivyMD中循环创建的列表项点击仅播放同一音乐的问题？

问题原因 #

你遇到的是Python闭包的常见陷阱：循环里定义的lambda表达式不会捕获迭代时FILE_PATH的当前值，而是持有对该变量的引用。循环结束后，所有lambda都指向最后一次循环的FILE_PATH，所以点击任意列表项都会播放同一首音乐。

解决方案 #

提供两种简单的修复方式：

方法1：给lambda添加默认参数 #

通过默认参数强制绑定当前循环的FILE_PATH值，避免引用共用变量：

import os
from kivymd.uix.list import TwoLineListItem

# 循环部分代码修改
ID = 0
for FILE, PATH in self.MUSIC.items():
    LIST_MUSIC = TwoLineListItem(
        text=f"{FILE}{ID}",
        secondary_text=PATH,
        font_style="Caption"
    )
    ID += 1
    LIST_MUSIC.id = str(ID)
    
    FILE_PATH = os.path.join(LIST_MUSIC.secondary_text, LIST_MUSIC.text)
    
    # 给lambda添加默认参数，绑定当前FILE_PATH值
    LIST_MUSIC.bind(on_press=lambda x, file_path=FILE_PATH: self.Play_Music(file_path))
    
    IDS.MUSIC_LIST.add_widget(LIST_MUSIC)

方法2：使用functools.partial #

用partial提前固定Play_Music的参数，逻辑更直观：

import os
from functools import partial
from kivymd.uix.list import TwoLineListItem

# 循环部分代码修改
ID = 0
for FILE, PATH in self.MUSIC.items():
    LIST_MUSIC = TwoLineListItem(
        text=f"{FILE}{ID}",
        secondary_text=PATH,
        font_style="Caption"
    )
    ID += 1
    LIST_MUSIC.id = str(ID)
    
    FILE_PATH = os.path.join(LIST_MUSIC.secondary_text, LIST_MUSIC.text)
    
    # 用partial绑定对应音乐路径
    LIST_MUSIC.bind(on_press=partial(self.Play_Music, FILE_PATH))
    
    IDS.MUSIC_LIST.add_widget(LIST_MUSIC)

原理说明 #

• 方法1中，默认参数的赋值在循环迭代时完成，每次循环都会把当前FILE_PATH的具体值绑定到参数上，避开了引用共用变量的问题。
• 方法2的partial会生成新的函数对象，提前将对应音乐路径作为固定参数传入Play_Music，确保每个列表项绑定的都是自身对应的路径。

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