Jupyter Notebook 2026年最新安装配置问题总结

提示：点击关注作者，以获取其他的最新消息推送

前言

最近在安装Jupyter Notebook做模型预训练的时候发现一些小问题，比如如何汉化，如何配置根目录这些，我将这些问题汇总起来，希望能够帮助到后面学习python数据分析的朋友们。

Jupyter Notebook 安装配置问题总结

一、中文包安装

问题：语言包装到了错误的 Python 环境

现象

• 在 CMD 执行 pip install jupyterlab-language-pack-zh-CN 安装成功
• Jupyter 重启后在 Settings → Language 中找不到中文选项

原因

• 电脑存在多个 Python 环境（例如D:\Program Files\Python311 和 D:\ProgramData\anaconda3）
• CMD 中的 pip 指向 D:\Program Files\Python311，而 Jupyter 运行在 Anaconda 环境（D:\ProgramData\anaconda3）
• 语言包安装到了不相关的 Python 环境中，Jupyter 无法加载

排查方法

1. 检查系统中安装了哪些 Python 环境

在 CMD 中依次执行以下命令：

where python

该命令列出系统中所有在 PATH 中的 Python 路径，每个路径对应一个独立的 Python 环境。如果输出多行，说明存在多个 Python 环境。

where pip

同样列出所有 pip 的位置。注意 CMD 中默认调用的 pip 是排在最前面的那个，不一定与 Jupyter 所在的 Python 是同一个。

2. 定位 Jupyter 实际运行在哪个 Python 环境

where jupyter

查看 Jupyter 可执行文件路径。若该命令无输出（如本例），说明 Jupyter 不在系统 PATH 中。

3. 通过快捷方式定位 Jupyter 所在环境

右键开始菜单 Jupyter 快捷方式 → 打开文件位置 → 属性 → 目标，其中第一个路径即为 Jupyter 实际使用的 Python 环境（本例为 D:\ProgramData\anaconda3\python.exe）。

4. 验证当前 CMD 的 pip 归属

pip --version

输出末尾会显示 pip 所属的 Python 路径，与第 3 步对比即可判断是否一致。

解决方法

• 打开 Anaconda Prompt（开始菜单搜索），在其中执行：

  pip install jupyterlab-language-pack-zh-CN
  

• 安装完成后重启 Jupyter，Settings → Language → 选择"中文 (简体)"即可
  

二、Anaconda Assistant 汉化

问题：Anaconda Assistant 无法设置为中文

现象

• Jupyter Notebook 主界面已成功汉化，但右侧 Anaconda Assistant 面板仍为英文

原因

• Anaconda Assistant 是 Anaconda 内置的独立 AI 插件，界面语言固定为英文
• 不跟随 Jupyter 的语言设置，也没有独立的语言切换选项
• 产品本身不支持中文界面

结论

• 无解，只能使用英文界面

三、修改根目录

问题一：快捷方式参数覆盖配置文件

现象

• 在 jupyter_notebook_config.py 中设置了 c.ServerApp.root_dir，重启后根目录未改变

原因

• 快捷方式"目标"末尾的 %USERPROFILE% 参数会将根目录强制锁定到用户目录，覆盖配置文件中的 root_dir 设置

解决方法

第一步：生成配置文件（若已存在可跳过）

在 Anaconda Prompt 中执行：

jupyter notebook --generate-config

配置文件生成路径为 C:\Users\<用户名>\.jupyter\jupyter_notebook_config.py。

第二步：编辑配置文件

打开上述配置文件，找到被注释的 # c.ServerApp.root_dir = ''，去掉 # 并填入目标路径：

c.ServerApp.root_dir = 'D:\\MyNotebooks'

注意路径分隔符必须使用双反斜杠 \\，或使用 r 前缀：r'D:\MyNotebooks'。

第三步：修改快捷方式

1. 右键 Jupyter 快捷方式 → 属性
   
2. 在"目标(T)"中删除末尾的 %USERPROFILE%
3. 将"起始位置(S)"改为目标目录路径

4. 保存后重启 Jupyter

问题二：目标文件夹不存在的静默失败

现象

• 配置文件已设置 c.ServerApp.root_dir = 'D:\\MyNotebooks'
• 快捷方式 %USERPROFILE% 已删除
• 重启后根目录仍未改变

原因

• 目标文件夹未提前创建，Jupyter 静默回退到默认目录

解决方法

• 先在资源管理器中创建目标文件夹（如 D:\MyNotebooks），确保路径存在且可访问

四、关键操作速查