在麒麟os上安装jupyter notebook首选pip3用户级安装,需先补全python环境(pip3、dev、venv),配置清华源加速,并将~/.local/bin加入path;失败时可用miniforge创建隔离环境。

在麒麟OS上安装Jupyter Notebook需先确认Python环境是否就绪,再选择适配性最强的安装路径——直接使用pip3用户级安装最稳妥,避免系统级冲突;若失败,则切换清华源或改用Miniforge隔离环境。
检查并补全Python基础环境
麒麟OS桌面版V10 SP1起通常预装Python 3.8或3.9,但常缺pip3、dev头文件或venv模块,不补全会导致后续所有安装命令报错。
打开终端,依次执行以下命令:
python3 --version → 查看是否输出3.6以上版本;若无响应,说明Python未安装或损坏,需通过软件中心搜索“python3”安装完整包。
pip3 --version → 若提示command not found,运行sudo apt update && sudo apt install python3-pip python3-dev python3-venv -y补全依赖。
python3 -m venv test-env && rm -rf test-env → 验证venv模块可用性,失败则必须重装python3-venv。
用户级安装Jupyter Notebook(推荐首选)
这一步操作起来很简单,直接在终端中输入命令即可,无需sudo,不会污染系统全局环境,卸载也只需删掉~/.local目录下对应文件。
执行pip3 install --user jupyter。
安装完成后运行python3 -m jupyter notebook --version,若输出版本号(如6.5.4),说明模块已成功注册到Python路径。
【关键】若执行jupyter notebook提示command not found,必须将用户本地bin目录加入PATH:echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc。
加速安装:永久配置清华镜像源
麒麟OS默认PyPI源在国内访问极慢,常导致pip install超时中断,尤其在安装jupyter这类含数十个依赖的包时几乎必败。
方法一(推荐):创建pip配置文件
mkdir -p ~/.pip
nano ~/.pip/pip.conf
写入以下两行并保存退出:
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple/
方法二(临时应急):下次安装时加参数,例如pip3 install --user -i https://pypi.tuna.tsinghua.edu.cn/simple/ jupyter。
替代方案:用Miniforge创建隔离环境
当pip3安装反复失败、内核识别异常或需多版本Python共存时,Miniforge比Anaconda更适配麒麟OS x86_64平台,且自带conda-forge科学计算栈。
第一步:下载并静默安装
wget https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-Linux-x86_64.sh
chmod +x Miniforge3-Linux-x86_64.sh && ./Miniforge3-Linux-x86_64.sh -b -p $HOME/miniforge3
第二步:初始化并激活新环境
$HOME/miniforge3/bin/conda init bash → 关闭终端再重开
conda create -n jupenv python=3.10 && conda activate jupenv
第三步:安装并注册内核
conda install jupyter ipykernel && python -m ipykernel install --user --name jupenv --display-name "Python (jupenv)"











