NameError本质是作用域中找不到变量定义；避免方法包括：替换前确保变量已赋值、注意函数内外作用域、用字典解包替代裸变量、区分字面量与变量名。
变量未定义报错（nameerror: name 'xxx' is not defined）本质是 python 在当前作用域找不到该名称的定义。配置变量替换本身不直接“解决”这个错误，但合理设计变量定义、作用域和替换逻辑，能从源头避免它发生。
确保变量在替换前已正确定义
变量替换（如用 str.format()、f-string 或 string.Template）的前提是：所有被引用的变量名必须已在作用域中存在且已赋值。
- 写 f-string 前，先确认变量已赋值：
name = "Alice"<br>message = f"Hello, {name}" # ✅ 正确message = f"Hello, {username}" # ❌ NameError，username 未定义 - 使用
format()时，传入的参数名必须与占位符匹配且已定义：print("Age: {age}".format(age=25)) # ✅print("Age: {age}".format()) # ❌ age 未传入，运行时报 KeyError，但若 age 是变量名未定义则先报 NameError
注意作用域，尤其在函数或模块间替换
变量替换常发生在函数内部或配置文件加载后，此时需特别留意作用域是否覆盖。
- 函数内做字符串替换，所用变量不能仅在外部定义而未声明为
global或作为参数传入：CONFIG_PATH = "/data"<br>def load_config():<br> return f"Loading from {CONFIG_PATH}" # ✅ 全局变量可读def save_data():<br> CONFIG_PATH = "/backup" # 此处赋值会创建局部变量<br> return f"Saving to {CONFIG_PATH}" # ✅ 读的是局部变量<br>def bad_example():<br> print(f"Using {CONFIG_PATH}") # ❌ 若上面 save_data 已执行且未加 global，可能意外覆盖或引发混淆 - 从配置文件（如 JSON/YAML）读取后，应显式将键转为变量或存入字典再替换，避免直接拼接未校验的键名：
config = {"host": "localhost", "port": 8080}<br>url = f"http://{config['host']}:{config['port']}" # ✅ 安全访问字典url = f"http://{host}:{port}" # ❌ host/port 未定义，即使 config 里有也不自动映射
用字典解包替代裸变量名替换，提升健壮性
相比直接在 f-string 中写变量名，把待替换内容组织成字典，再用 **dict 解包，既能集中管理，又能提前暴露缺失项。
values = {"user": "Bob", "level": "admin"}<br>msg = "User {user} logged in with {level} access".format(**values) # ✅ 缺少 key 会报 KeyError，比 NameError 更易定位- 配合
locals()或globals()要谨慎：x = 10; y = 20<br>print("{x} + {y} = {result}".format(**locals(), result=x+y)) # ✅ 可行但不推荐用于生产，可读性差
检查字符串引号，别把字面量当变量
一个高频低级错误：本意是替换固定文本，却漏了引号，让 Python 误以为是变量名。
-
status = "success"<br>log = f"Operation: {status}" # ✅log = f"Operation: {success}" # ❌ success 未定义，报 NameError - 模板中若含固定字符串，务必加引号；动态部分才用花括号：
f"Path: {'/tmp'} and user: {username}"
