直接改 c.notebookapp.language 不生效,是因为传统 jupyter notebook 不支持该参数,仅 jupyterlab 读取它;经典 notebook 唯一有效方式是设置系统环境变量 lang=zh_cn.utf-8,并完全重启服务。

为什么直接改 c.NotebookApp.language 不生效?
很多用户在 jupyter_notebook_config.py 里写上 c.NotebookApp.language = 'zh-CN' 后重启,界面仍是英文——这不是配置写错了,而是传统 Notebook(非 JupyterLab)根本不支持这个参数。该配置项只对 JupyterLab 有效,而 notebook 包(即经典 Notebook)压根不读取它。强行设置不会报错,但也不会起作用。
经典 Notebook 真正有效的配置方式是环境变量
经典 Notebook 的语言判定逻辑非常简单:启动时检查系统级 LANG 环境变量,仅当其值为 zh_CN.UTF-8(注意是下划线,不是短横线)时,才启用中文界面。其他任何 Python 层面的配置(包括修改配置文件、调用 API)都无效。
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- Windows 用户:在「系统属性 → 高级 → 环境变量」中新建用户变量,
变量名填LANG,变量值填zh_CN.UTF-8 - macOS/Linux 用户:在
~/.zshrc或~/.bash_profile中添加export LANG=zh_CN.UTF-8,然后执行source ~/.zshrc - 必须完全关闭所有 Jupyter 进程(包括后台服务),再重新启动
jupyter notebook才会读取新变量
JupyterLab 配置文件中设置中文的正确写法
如果你用的是 jupyter lab(而非 jupyter notebook),那 c.NotebookApp.language 才真正起作用。但要注意:它必须写在 jupyter_lab_config.py 中,且需配合语言包安装。
- 先确保已安装
jupyterlab-language-pack-zh-CN,且安装位置与 JupyterLab 运行的 Python 环境一致(常用排查命令:where jupyter和pip --version对比路径) - 生成配置文件:
jupyter lab --generate-config - 编辑
jupyter_lab_config.py,加入一行:c.LabApp.language = 'zh-CN'(注意是c.LabApp.language,不是c.NotebookApp.language) - 重启
jupyter lab,Settings → Language 应出现「中文(简体)」选项
最容易被忽略的兼容性细节
即使环境变量或配置都正确,仍可能看到部分按钮仍是英文——这是因为经典 Notebook 的汉化覆盖范围有限,比如右键菜单、某些弹窗、内核状态提示等并未全部翻译。JupyterLab 的汉化更完整,但依赖语言包版本。2026 年最新版 jupyterlab-language-pack-zh-CN 支持 JupyterLab ≥ 4.2,若你用的是旧版 Lab(如 3.x),得降级安装对应语言包,否则 c.LabApp.language 会被静默忽略。










