修改Jupyter Notebook主题时出现NameError: name 'jt' is not defined报错如何解决

错误触发核心原因 #

jt是jupyterthemes提供的终端命令行工具，出现NameError: name 'jt' is not defined绝大多数情况是你把该命令直接输入到了Jupyter Notebook的Python代码单元格中执行，Python解释器会把jt识别为未定义的变量而非系统命令。

解决方案 #

• 场景1：命令执行位置错误
  直接打开系统终端（Windows为cmd/PowerShell，macOS/Linux为终端），输入jt -l即可列出所有可用主题。
  如果你需要在Jupyter Notebook的代码单元格中执行该命令，只需在命令前加感叹号即可：

  !jt -l
  

• 场景2：终端执行仍然报错，为系统PATH未包含pip安装路径
  这是因为pip安装的可执行文件目录没有加入系统环境变量，根据操作系统不同处理：
  • Windows：找到Python安装目录下的Scripts文件夹（默认路径为C:\Users\你的用户名\AppData\Local\Programs\Python\Python版本号\Scripts），将该路径添加到系统环境变量PATH中，重启终端后即可生效。
  • macOS/Linux：将用户级pip安装目录~/.local/bin加入shell配置，编辑~/.bashrc（bash用户）或~/.zshrc（zsh用户），添加一行export PATH=$PATH:~/.local/bin，保存后执行source ~/.bashrc或source ~/.zshrc即可生效。
• 场景3：多Python环境/虚拟环境导致的安装不匹配
  如果你用了conda、venv等虚拟环境，或者系统安装了多个Python版本，需要先激活对应Jupyter所在的虚拟环境，再重新执行安装命令：

  pip install jupyterthemes
  

  也可以直接用Python模块调用的方式绕开PATH问题，无需修改环境变量：

  # 终端执行
  python -m jupyterthemes -l
  # Notebook单元格执行
  !python -m jupyterthemes -l
  

验证生效 #

主题修改完成后（比如执行jt -t onedork设置onedork主题），重启Jupyter Notebook即可看到界面样式更新。

内容的提问来源于stack exchange，提问作者Qas