### Python 中 `NameError: name 'key' is not defined` 错误与变量作用域解决方案 当在函数中遇到 `NameError: name 'key' is not defined` 时，通常是因为尝试访问一个未定义或不可见的变量。这种错误主要由以下原因引起： 1. **变量未声明** 如果变量 `key` 在使用前没有被赋值，则会引发此错误。例如，在函数内部直接使用未经初始化的变量会导致该问题[^1]。 2. **作用域冲突** 根据 LEGB 规则（Local -> Enclosing -> Global -> Built-in），Python 按照局部作用域、嵌套作用域、全局作用域和内置作用域依次查找变量。如果在函数内部给变量赋值，默认将其视为局部变量，除非明确声明其为全局变量[^2]。 3. **参数缺失** 若函数期望接收某个名为 `key` 的参数而实际调用时并未传入对应的值，也会触发类似的错误提示。 #### 解决方案 以下是几种常见的解决方法： 1. **确保变量已正确定义并赋值** 在任何操作之前，请确认目标变量已被显式地创建和赋予初始值。例如： ```python def get_page(key=None): if key is None: raise ValueError("Key parameter must be provided.") # 继续处理逻辑... ``` 2. **使用 `global` 声明全局变量** 如果希望在函数内部修改全局变量而不是创建一个新的局部变量，可以使用 `global` 关键字进行声明。例如： ```python key = "default_value" def modify_global_variable(): global key key = "new_value" print(f"Inside function: {key}") # 输出 new_value modify_global_variable() print(f"Outside function: {key}") # 输出 new_value ``` 3. **通过参数传递变量** 将必要的数据作为参数传递给函数，避免依赖外部环境中的同名变量。这种方法不仅提高了代码可读性，还减少了意外覆盖的风险。 ```python def get_page(key): try: response = requests.get(f"https://example.com/{key}") response.raise_for_status() # 检查请求是否成功 return response.text except Exception as e: print(f"An error occurred: {e}") if __name__ == "__main__": search_key = input("Enter the page identifier: ") content = get_page(search_key) if content: print(content[:100]) # 打印部分内容作为测试 ``` 4. **利用闭包捕获外层变量** 对于嵌套函数场景下的变量共享需求，可通过闭包实现对外围作用域中变量的引用而不需额外声明。 ```python def outer_function(param): value = param def inner_function(): nonlocal value # 明确指出此处使用的value来自外围而非新建本地副本 value += "_modified" print(value) return inner_function func_instance = outer_function("initial") func_instance() # 输出 initial_modified ``` 5. **借助类封装状态信息** 当涉及更复杂的状态管理和行为组合时，考虑采用面向对象设计模式，将相关联的数据与方法集中到一起便于管理。 ```python class PageFetcher: def __init__(self, base_url="https://example.com/"): self.base_url = base_url def fetch(self, key): url = f"{self.base_url}{key}" try: response = requests.get(url) response.raise_for_status() return response.text except Exception as e: print(f"Failed to retrieve data from URL={url}, Error={str(e)}") pf = PageFetcher() result = pf.fetch(input("Please enter your query term: ")) if result: print(result[:100]) ``` --- ###