该提问与当前博客内容无直接关联。 这是一个典型的Python运行时错误，源于**模块导入顺序不当**导致的`NameError`。具体而言，在尝试配置matplotlib的字体参数时，尚未导入matplotlib.pyplot模块，因此解释器无法识别`plt`这个标识符。 ### 错误分析与解决方案 **1. 错误根源解析** 错误信息 `NameError: name 'plt' is not defined` 明确指出，在代码执行到第12行 (`plt.rcParams['font.sans-serif'] = ...`) 时，Python解释器在当前的命名空间中找不到名为 `plt` 的变量或模块。 在Python中，模块（module）是包含函数、类和变量的文件。在使用其内容前，必须通过 `import` 语句将其导入到当前命名空间。`plt` 通常是 `matplotlib.pyplot` 模块的约定别名。如果在使用 `plt.` 之前没有执行 `import matplotlib.pyplot as plt`，就会引发此错误。 **2. 修复方案** 解决方案是确保在使用任何模块功能之前，先导入该模块。以下是修改后的正确代码结构： ```python # 正确的导入顺序：先导入模块，再使用其功能 import matplotlib.pyplot as plt # 首先导入并设置别名 import numpy as np import pandas as pd # 现在可以安全地配置rcParams，因为plt已经在命名空间中定义 plt.rcParams['font.sans-serif'] = ['PingFang SC', 'Arial Unicode MS', 'SimHei'] # 设置中文字体 plt.rcParams['axes.unicode_minus'] = False # 解决负号显示为方块的问题 # 后续的绘图代码... # plt.figure() # plt.plot(...) # plt.show() ``` **3. 最佳实践与扩展说明** * **导入集中化**：建议将所有 `import` 语句放在Python脚本或Jupyter Notebook单元格的开头。这不仅避免了 `NameError`，也使代码依赖关系一目了然。 * **模块别名惯例**：遵循社区惯例（如 `import numpy as np`, `import pandas as pd`, `import matplotlib.pyplot as plt`）能提高代码的可读性。 * **字体配置的完整方案**：中文字体显示问题通常需要更完整的配置。以下是一个更健壮的配置示例，考虑了不同操作系统： ```python import matplotlib.pyplot as plt import matplotlib # 方案一：通用字体列表（优先级从高到低） font_list = ['DejaVu Sans', 'Arial Unicode MS', 'SimHei', 'Microsoft YaHei', 'PingFang SC', 'Hiragino Sans GB'] plt.rcParams['font.sans-serif'] = font_list plt.rcParams['axes.unicode_minus'] = False # 方案二：直接指定系统字体路径（适用于自定义字体） # font_path = '/System/Library/Fonts/PingFang.ttc' # macOS # font_path = 'C:/Windows/Fonts/simhei.ttf' # Windows # matplotlib.font_manager.fontManager.addfont(font_path) # font_name = matplotlib.font_manager.FontProperties(fname=font_path).get_name() # plt.rcParams['font.sans-serif'] = [font_name] ``` **4. 调试与预防建议** 1. **运行时检查**：在复杂的脚本中，可以在使用模块前添加一个简单的检查（虽然不推荐替代正确的导入）： ```python try: plt.title("测试") except NameError: print("错误：请先导入matplotlib.pyplot模块") import matplotlib.pyplot as plt print("已补救导入，但请修正代码结构。") ``` 2. **IDE/Linter工具**：使用PyCharm、VS Code等集成开发环境或配置Pylint、Flake8等代码检查工具，它们通常能在运行前就识别出未导入的模块并给出警告。 3. **模块作用域理解**：牢记在Python中，每个模块都有独立的作用域。在Jupyter Notebook中，虽然单元格之间存在一定的状态共享，但为了代码清晰和可移植性，每个需要使用的单元格都应包含必要的导入语句。 ### 总结 `NameError: name 'plt' is not defined` 是一个基础的Python语法/结构错误，其根本原因是违反了“先定义，后使用”的原则。修复方法始终是确保在使用变量、函数或模块别名之前，已经通过赋值、定义或导入语句使其存在于当前命名空间中。对于matplotlib而言，标准的修复模式就是在脚本顶端执行 `import matplotlib.pyplot as plt`。将此作为固定的编码习惯，能有效避免此类错误，并提升代码的健壮性和可维护性。