Windows 上安装 Jupyter Notebook 全流程：从环境配置到避坑指南

简介这份PDF教程面向Windows平台零基础用户与数据分析初学者系统讲解Jupyter Notebook的安装与配置流程帮助读者解决环境搭建中常见的路径设置、镜像源配置等痛点。资源包内含1个PDF文件大小约1.54MB以图文步骤形式呈现便于离线阅读与对照操作。内容覆盖Anaconda与pip两种安装路径并详细说明清华镜像源配置、环境变量勾选、启动方式及浏览器访问地址等关键环节同时穿插Jupyter Notebook在数据分析、机器学习与科学计算中的交互式应用场景介绍。目前已有3026人学习下载适合需要快速完成Windows环境部署、减少踩坑时间的Python学习者与数据科学入门者参考使用。1. 装完就能跑Windows 上 Jupyter Notebook 到底解决什么问题很多人第一次在 Windows 上装 Jupyter Notebook卡住的地方不是 Python 本身而是「装完之后浏览器打不开」「命令行一闪而过」「默认保存路径找不到」。这篇就是把这些坑一次性讲透让你从零到能跑通第一个 notebook并且知道每一步为什么这么做。Jupyter Notebook 本质上是一个本地 Web 应用你在命令行启动一个服务它监听本机某个端口然后用浏览器打开一个交互页面在页面里写 Python 代码、跑结果、存成.ipynb文件。它适合做数据分析、机器学习实验、教学演示也适合把零散脚本整理成可复现的记录。Windows 上安装它的路径不止一条但最稳的是用 Anaconda 或 Miniconda 建独立环境再用 conda 装 Jupyter避免和系统里已有的 Python 互相打架。下面按「选型 → 安装 → 配置 → 排错 → 进阶」的顺序走每一步都给可抄的命令和参数说明。2. 选 Anaconda 还是 MinicondaWindows 安装 Jupyter Notebook 的两种路线2.1 为什么我不建议直接 pip install jupyter在 Windows 上直接pip install jupyter不是不行但很容易翻车。原因有三个第一系统里可能同时存在 Microsoft Store 版 Python、官网安装版 Python、以及某些软件自带的 Pythonpip指向哪个解释器经常是玄学第二Jupyter 依赖 zeromq、tornado 等带二进制扩展的包pip 源里预编译 wheel 和你的 Python 小版本对不上时会触发本地编译Windows 上缺 C Build Tools 就直接报错第三装完之后jupyter notebook命令不在 PATH 里命令行提示「不是内部或外部命令」。常见做法是用 conda 系工具建一个独立环境把 Jupyter 和后续要用的 numpy、pandas 一起装进去。conda 会处理二进制依赖Windows 上省心很多。Anaconda 是「全家桶」装完自带 Jupyter、Spyder、几百个科学计算包体积大但省事Miniconda 是「最小内核」只带 conda 和 PythonJupyter 需要自己装体积小、可控性强。如果你只是学 JupyterMiniconda 足够如果你不想折腾环境Anaconda 一步到位。2.2 Miniconda 安装步骤与 PATH 勾选去 Miniconda 官网下载 Windows 64 位安装包双击运行。安装向导里有两个勾选项容易让人犹豫Add Miniconda3 to my PATH environment variable官方建议不勾理由是可能干扰系统里其他软件。但如果你不勾后面就得用「Anaconda Prompt」这个专用命令行普通 cmd 里敲conda会找不到。我一般会勾上前提是这台机器上没有其他 Python 环境。Register Miniconda3 as my default Python建议勾上让.py文件默认用 Miniconda 的 Python 打开。安装完成后打开「Anaconda Prompt (Miniconda3)」输入conda --version python --version如果两条都能输出版本号说明基础环境就绪。如果conda报错检查安装时是否勾了 PATH或者手动把C:\Users\你的用户名\miniconda3\Scripts和C:\Users\你的用户名\miniconda3加到系统环境变量 Path 里。2.3 创建独立环境并安装 Jupyter不要直接在 base 环境里装东西这是血泪经验。base 环境一旦被搞乱修复起来很麻烦。正确做法是建一个专用环境conda create -n jupyter_env python3.11 -y conda activate jupyter_env conda install jupyter notebook -y参数说明-n jupyter_env指定环境名可以改成你喜欢的名字python3.11指定 Python 版本3.10 到 3.12 目前兼容性都比较好-y表示自动确认省去每次回车。安装完成后验证jupyter notebook --version能输出版本号就说明装好了。如果提示找不到命令确认当前环境是否激活——命令行前面应该显示(jupyter_env)。3. 启动、配置与默认保存路径让 Jupyter Notebook 按你的习惯工作3.1 启动命令与端口占用处理在激活的环境里输入jupyter notebook默认会启动服务并自动打开浏览器地址是http://localhost:8888/tree。如果 8888 端口被占用Jupyter 会自动往后找 8889、8890。你也可以手动指定jupyter notebook --port 9999如果浏览器没有自动弹出手动复制命令行里输出的 URL 到浏览器。注意 URL 里带 token 参数第一次访问需要这个 token后面可以设置密码免 token。3.2 修改默认保存路径的两种方法Jupyter 默认把 notebook 存在启动时所在的目录。如果你在C:\Users\你的用户名下启动文件就散落在用户目录里时间一长很难找。改默认路径有两种做法方法一启动时指定目录jupyter notebook --notebook-dirD:\jupyter_workspace每次都要敲一长串不现实。可以写一个.bat脚本放在桌面双击启动echo off call conda activate jupyter_env jupyter notebook --notebook-dirD:\jupyter_workspace pause方法二生成配置文件并永久修改jupyter notebook --generate-config这会在C:\Users\你的用户名\.jupyter\下生成jupyter_notebook_config.py。用文本编辑器打开找到# c.ServerApp.notebook_dir 这一行旧版本可能是c.NotebookApp.notebook_dir去掉前面的#在引号里填入你的路径c.ServerApp.notebook_dir D:\\jupyter_workspace注意 Windows 路径里的反斜杠要写成双反斜杠或者用正斜杠D:/jupyter_workspace。改完保存重新启动 Jupyter 即可生效。3.3 设置密码与关闭 token 验证每次启动都带一长串 token 很烦可以设置固定密码jupyter notebook password按提示输入两次密码它会把哈希写到jupyter_server_config.json里。之后启动 Jupyter浏览器只需要输密码不用再复制 token。如果你只在本地自己用也可以直接关闭 tokenc.ServerApp.token c.ServerApp.password 但这样同一局域网内其他人知道你的 IP 和端口就能访问不建议在公共网络下这么做。3.4 为 Jupyter Notebook 添加目录的插件配置notebook 文件一长没有目录跳转很痛苦。装jupyter_contrib_nbextensions可以解决conda install -c conda-forge jupyter_contrib_nbextensions -y jupyter contrib nbextension install --user重启 Jupyter 后首页会多一个「Nbextensions」标签页进去勾选「Table of Contents (2)」。之后打开任意 notebook左侧或顶部会出现目录按钮根据 Markdown 标题自动生成层级目录。如果 Nbextensions 页面空白通常是版本不匹配可以尝试用 pip 重装pip install jupyter_contrib_nbextensions jupyter contrib nbextension install --user4. Windows 上装 Jupyter Notebook 的避坑与排查4.1 命令行闪退或提示「jupyter 不是内部或外部命令」现象双击.bat脚本或直接在 cmd 里敲jupyter notebook窗口一闪而过或者提示命令不存在。原因conda 环境没有激活或者 Miniconda 的 Scripts 目录不在 PATH 里。.bat脚本里如果没有call conda activate双击时不会自动激活环境。解决在.bat里显式激活环境并用call而不是直接写conda activate。如果是在普通 cmd 里用先执行conda activate jupyter_env再执行jupyter notebook。检查 PATH 里是否包含miniconda3\Scripts和miniconda3\Library\bin。4.2 浏览器打开后显示「This site cant be reached」现象命令行显示 Jupyter 已启动但浏览器打不开localhost:8888。原因端口被防火墙拦截或者 Jupyter 绑定的是127.0.0.1而浏览器走了代理。Windows 上某些安全软件会拦截本地回环端口的监听。解决先换一个端口试试jupyter notebook --port 9999。如果还不行检查 Windows Defender 防火墙的入站规则允许 Python 或 Jupyter 相关进程。另外如果你系统里设置了全局代理把localhost和127.0.0.1加入代理例外列表。4.3 默认保存路径改了但不生效现象修改了jupyter_notebook_config.py里的notebook_dir重启后 Jupyter 还是打开原来的目录。原因配置文件里改错了字段名。Jupyter 版本更新后配置项从NotebookApp迁移到了ServerApp。旧版本用c.NotebookApp.notebook_dir新版本用c.ServerApp.notebook_dir。如果两个都写可能互相覆盖。解决先确认 Jupyter 版本jupyter notebook --version然后只保留一个正确的配置项。改完后在命令行加--debug启动看日志里实际加载的配置路径是哪个。4.4 安装插件后 Nbextensions 页面空白现象装完jupyter_contrib_nbextensions重启 JupyterNbextensions 标签页能点进去但列表是空的。原因nbextensions 的静态文件没有正确安装到 Jupyter 的搜索路径里或者 conda 和 pip 混装导致版本冲突。解决先卸载再重装统一用 pippip uninstall jupyter_contrib_nbextensions jupyter_nbextensions_configurator -y pip install jupyter_contrib_nbextensions jupyter_nbextensions_configurator jupyter contrib nbextension install --user jupyter nbextensions_configurator enable --user重启后如果还是空白检查jupyter --paths输出的 data 目录下是否有nbextensions文件夹。4.5 中文路径导致 notebook 无法保存现象notebook 能打开但保存时报错或者新建 notebook 时提示「Permission denied」。原因Jupyter 底层某些库对非 ASCII 路径支持不完善尤其是 Windows 上用户名是中文时默认路径C:\Users\中文名\容易出问题。解决把默认保存路径改到纯英文目录比如D:\jupyter_workspace。如果用户名已经是中文至少保证 notebook 文件本身放在英文路径下。这是最省事的做法不要去折腾编码转换。5. 进阶把 Jupyter Notebook 变成日常顺手工具的几个技巧装好只是第一步用顺手才是目的。第一个技巧是给 notebook 加目录前面已经讲了 Nbextensions但如果你用的是 JupyterLab 或者新版 Notebook 7内置的 Table of Contents 已经够用不需要额外装插件。第二个技巧是用%load_ext autoreload和%autoreload 2这样你修改了外部.py文件notebook 里 import 的模块会自动重载不用反复重启内核。第三个技巧是导出jupyter nbconvert --to html your_notebook.ipynb可以把 notebook 转成 HTML 发给别人对方不需要装 Jupyter 就能看。还有一个容易被忽略的点Windows 上 Jupyter 的启动速度受杀毒软件影响很大。如果你装了第三方安全软件把miniconda3目录和 notebook 工作目录加入白名单启动能快不少。另外如果你经常需要同时开多个 notebook建议用jupyter lab而不是jupyter notebook前者是多标签页界面管理多个文件更方便。我自己的习惯是每台新 Windows 机器先装 Miniconda建一个jupyter_env把默认路径改到D:\jupyter_workspace设好密码装好 Nbextensions然后写一个桌面.bat一键启动。这套流程走下来大概十分钟之后几年都不用再折腾环境。希望帮到你。本文还有配套的精品资源点击获取