如何在Python函数内检查并将字符串参数转换为列表类型

我写了一个包含多个参数的函数，想要检查其中部分参数是否为list类型，将非list类型的参数转换为list类型。在函数外执行这类逻辑是可行的，但放到函数中却失效了。

函数外可行的处理示例 #

单个变量转换 #

parameter_1 = 'a'
if type(parameter_1) is not list:
    parameter_1 = list(parameter_1.split())
print(parameter_1, type(parameter_1))

输出：

['a'] <class 'list'>

遍历变量列表转换（使用locals()） #

parameter_1 = 'a'
parameter_2 = ['b','c']
process_list = ['parameter_1', 'parameter_2']
for i in process_list:
    if type(locals()[i]) is not list:
        locals()[i] = list(locals()[i].split())
print(parameter_1, type(parameter_1))

输出：

['a'] <class 'list'>

函数内失效的代码及现象 #

def my_function(
    parameter_1='d',
    parameter_2=['e','f']
):
    process_list = ['parameter_1', 'parameter_2']
    for i in process_list:
        if type(locals()[i]) is not list:
            print('recognised:', i, locals()[i], type(locals()[i]))
            locals()[i] = list(locals()[i].split())
            print('after conversion:', locals()[i], type(locals()[i]))
    print(parameter_1, type(parameter_1))
my_function()

实际输出：

recognised: parameter_1 d <class 'str'>
after conversion: d <class 'str'>
d <class 'str'>

预期输出：

recognised: parameter_1 d <class 'str'>
after conversion: ['d'] <class 'list'>
['d'] <class 'list'>

问题原因 #

函数内调用locals()返回的局部变量字典，修改它并不一定会同步到实际的局部变量。Python规范明确说明，locals()返回的可能是局部变量的副本，直接修改字典内容属于未定义行为，无法保证会改变原变量的值，这就是转换逻辑失效的核心原因。

解决方案 #

方案1：用字典统一管理参数（推荐） #

将参数存入字典，处理后再赋值回原变量，避免直接操作locals()：

def my_function(
    parameter_1='d',
    parameter_2=['e','f']
):
    # 把参数存入字典
    params = {
        'parameter_1': parameter_1,
        'parameter_2': parameter_2
    }
    process_list = ['parameter_1', 'parameter_2']
    for key in process_list:
        if not isinstance(params[key], list):
            params[key] = list(params[key].split())
    # 将处理后的参数赋值回原变量
    parameter_1, parameter_2 = params['parameter_1'], params['parameter_2']
    print(parameter_1, type(parameter_1))

my_function()

输出：

['d'] <class 'list'>

方案2：逐个检查转换（参数较少时适用） #

如果参数数量不多，直接逐个判断转换，逻辑更直观：

def my_function(
    parameter_1='d',
    parameter_2=['e','f']
):
    if not isinstance(parameter_1, list):
        parameter_1 = list(parameter_1.split())
    if not isinstance(parameter_2, list):
        parameter_2 = list(parameter_2.split())
    print(parameter_1, type(parameter_1))

my_function()

方案3：使用inspect模块（进阶场景） #

如果需要动态处理大量参数，可以用inspect模块获取当前函数的局部变量帧，但仍建议优先用字典方案：

import inspect

def my_function(
    parameter_1='d',
    parameter_2=['e','f']
):
    process_list = ['parameter_1', 'parameter_2']
    # 获取当前函数的局部变量帧
    frame = inspect.currentframe()
    local_vars = frame.f_locals
    for key in process_list:
        val = local_vars[key]
        if not isinstance(val, list):
            local_vars[key] = list(val.split())
    # 重新绑定变量以确保更新生效
    parameter_1 = local_vars['parameter_1']
    print(parameter_1, type(parameter_1))

my_function()

额外注意事项 #

• 优先用isinstance()替代type()：isinstance()支持继承关系，更符合Python的多态设计，比如如果有继承自list的自定义类，isinstance()能正确识别。
• 避免可变类型默认参数陷阱：函数默认参数如果用[]这类可变对象，会在函数定义时创建，多次调用会共享同一个实例。建议用None作为默认值，在函数内初始化：

  def my_function(parameter_2=None):
      if parameter_2 is None:
          parameter_2 = ['e','f']
      # 后续处理逻辑
  

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