在 Jupyter Notebook 中遇到 `NameError` 时，通常表示尝试访问的名称（变量、函数、模块等）未被定义或无法识别。以下是几种常见的原因及其解决方法： ### 检查拼写错误 最常见的原因是拼写错误或大小写不一致。Python 是区分大小写的语言，因此需要确保变量名、函数名和模块名完全匹配。 ```python # 错误示例 Print("Hello World") # NameError: name 'Print' is not defined # 正确示例 print("Hello World") ``` ### 确保变量已定义 在使用变量之前，必须先进行定义。如果尝试使用未赋值的变量，会引发 `NameError`。 ```python # 错误示例 print(x) # NameError: name 'x' is not defined # 正确示例 x = 5 print(x) ``` ### 检查模块导入语句 如果导入的模块或其特定属性未正确加载，则可能导致 `NameError`。请确认导入语句是否正确，并且模块已安装。 ```python # 错误示例 from math import squrt # NameError: name 'squrt' is not defined # 正确示例 from math import sqrt print(sqrt(16)) ``` ### 处理第三方库的版本问题 有时 `NameError` 可能与第三方库的版本兼容性有关。例如，在引用[3]中提到的 `pandas` 兼容性问题，可能是由于依赖库版本不匹配导致的。可以通过升级或降级相关包来解决此类问题[^3]。 ```bash pip install pandas --upgrade ``` ### 验证 Jupyter 内核配置 如果某些模块在命令行中可以正常导入，但在 Jupyter Notebook 中出现 `NameError`，则可能是 Jupyter 使用的内核路径与实际 Python 环境不一致。可以检查并修改 `kernel.json` 文件中的 Python 路径以匹配命令行使用的解释器[^4]。 ### 示例：修复内核配置 打开 `kernel.json` 文件并调整 `"argv"` 中的 Python 解释器路径： ```json { "display_name": "Python 3", "language": "python", "argv": [ "/usr/bin/python3", // 替换为你的 Python 解释器路径 "-m", "ipykernel_launcher", "-f", "{connection_file}" ] } ``` ### 安装缺失的依赖 如果报错涉及某个特定模块的缺失，请尝试通过 `pip` 或 `conda` 安装相应的依赖。 ```bash pip install markupsafe==2.0.1 # 解决 soft_unicode 相关问题 [^2] ``` ### 清理缓存和重启内核 Jupyter Notebook 的缓存可能导致一些不可预见的问题。尝试重启内核 (`Kernel > Restart`) 或清除输出后重新运行代码单元格。 ---