### Jupyter Notebook 启动时出现 `No module named 'ipython_genutils'` 的解决方案 当尝试启动 Jupyter Notebook 时，如果遇到错误提示 `ModuleNotFoundError: No module named 'ipython_genutils'`，这通常意味着当前 Python 环境中缺少必要的模块 `ipython_genutils` 或其版本不兼容。 以下是详细的解决方法： #### 方法一：重新安装缺失的模块 可以通过以下命令来安装或重新安装 `ipython_genutils` 模块： ```bash pip install ipython_genutils ``` 或者，如果您正在使用特定版本的 Python（例如 Python 3），可以指定对应的解释器： ```bash python3 -m pip install ipython_genutils ``` 此操作会确保该模块被正确安装到您的环境中[^2]。 --- #### 方法二：更新 Jupyter 和相关依赖项 有时，问题可能源于旧版 Jupyter 及其依赖项之间的冲突。因此，建议通过以下命令全局更新 Jupyter 和相关组件： ```bash pip install --upgrade jupyter ``` 对于更复杂的环境管理情况，推荐单独更新 `ipython_genutils` 和其他核心依赖项： ```bash pip install --upgrade traitlets nbformat notebook ipython_genutils ``` 这些命令有助于修复潜在的版本不匹配问题[^4]。 --- #### 方法三：创建独立的虚拟环境 为了避免不同项目间的依赖冲突，强烈建议为 Jupyter 创建一个新的虚拟环境并在此环境下安装所需软件包。具体步骤如下： 1. **创建虚拟环境** ```bash python3 -m venv my_jupyter_env ``` 2. **激活虚拟环境** 在 Linux/macOS 下： ```bash source my_jupyter_env/bin/activate ``` 在 Windows 下： ```bash my_jupyter_env\Scripts\activate ``` 3. **安装 Jupyter 和必要依赖** ```bash pip install jupyter ipython_genutils ``` 完成以上步骤后，在新环境中再次测试 Jupyter 是否正常工作。 --- #### 方法四：检查系统路径和多版本 Python 冲突 某些情况下，尤其是操作系统预装了多个 Python 版本时，可能导致 Pip 安装的目标路径与实际使用的 Python 不一致。此时可执行以下诊断命令以确认路径一致性： ```bash which python3 which pip ``` 如果两者指向不同的位置，则需显式绑定它们的关系。例如： ```bash python3 -m pip install ipython_genutils ``` 此外，还可以验证是否存在重复安装的情况： ```bash pip list | grep ipython_genutils ``` 如果有冗余条目，考虑卸载后再重试安装： ```bash pip uninstall ipython_genutils pip install ipython_genutils ``` --- #### 方法五：清理缓存数据 Pip 缓存中的损坏文件也可能引发此类问题。清除缓存后重新安装模块是一种有效的补救措施： ```bash pip cache purge pip install ipython_genutils ``` --- ### 总结 上述方法涵盖了从简单安装到复杂环境调整的各种场景。优先尝试最简单的选项——即直接安装缺失模块；若仍无法解决问题，则逐步排查环境配置、依赖关系及路径设置等问题。 ---