终端启动Jupyter Notebook失败，markupsafe导入错误求助

错误原因 #

你遇到的ImportError: cannot import name 'soft_unicode' from 'markupsafe'是版本兼容问题：Markupsafe 2.1及以上版本移除了soft_unicode函数（重命名为soft_str），但当前Jupyter依赖的Jinja2版本仍在尝试导入这个已被移除的函数，导致启动失败。这种情况通常是安装其他库时自动升级了Markupsafe版本引发的。

解决方案 #

可以通过以下两种方式解决：

方法1：降级Markupsafe到兼容版本 #

执行以下命令将Markupsafe降级到2.0.x系列（与旧版Jinja2兼容）：

pip install markupsafe==2.0.1

如果你的系统中存在多个Python版本，可能需要用pip3代替pip。

方法2：升级Jinja2到适配新版Markupsafe的版本 #

执行命令升级Jinja2，使其支持Markupsafe 2.1+的API：

pip install --upgrade jinja2

验证 #

完成上述操作后，重新在终端执行jupyter notebook，应该可以正常启动程序。

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