### Python `locals()` 函数详解 `locals()` 函数返回当前局部符号表的字典副本。这个函数通常用于动态获取或修改本地作用域内的变量名及其对应的对象。 #### 获取局部变量 当在一个函数内部调用 `locals()` 时，可以查看该函数内定义的所有局部变量： ```python def test_locals(): a = 10 b = "hello" local_vars = locals() print(local_vars) test_locals() ``` 上述代码会打印出包含两个键值对的字典，分别对应于变量 `a` 和 `b` 的名称与其赋值[^1]。 #### 修改局部变量 需要注意的是，在某些情况下尝试通过 `locals()` 返回的对象来改变局部变量的行为可能不会按预期工作；对于不可变类型的变量来说尤其如此。这是因为 CPython 实现细节所致——即在函数体内直接更新由 `locals()` 得到的结果未必能真正影响实际的作用域环境[^2]。 然而，如果确实希望利用此特性实现某种特殊逻辑，则应谨慎行事并充分测试其行为是否符合需求。 #### 使用场景举例 一种常见的应用场景是在模板渲染引擎中传递上下文数据给视图层处理。此时可以通过收集所有必要的参数放入一个临时命名空间里再一并传入目标方法之中以便简化接口设计: ```python from string import Template template_str = "$greeting, $name!" def render_template(greeting, name): context = {"greeting": greeting, "name": name} template = Template(template_str) # 将context中的key-value加入到local环境中 for key, value in context.items(): locals()[key] = value result = template.substitute(locals()) return result print(render_template("Hi", "Alice")) # 输出: Hi, Alice! ``` 尽管这里展示了如何使用 `locals()` 来填充模板字符串所需的占位符替换映射关系，但在生产级应用开发实践中更推荐采用显式的参数列表方式以提高可读性和维护性。