permissionerror: [errno 13] permission denied 根本原因是jupyter尝试在受限路径(如windows的appdata oamingjupyter untime或linux/macos的~/.local/share/jupyter/runtime)写入临时文件时被系统拒绝;稳定解法是通过jupyter_notebook_config.py同时指定notebook_dir和runtime_dir至用户有完全权限的自定义路径。

PermissionError: [Errno 13] Permission denied 这类错误不是 Jupyter 本身坏了,而是它试图写文件时被操作系统拦下了——常见于 C:Users\AppDataRoamingjupyter
untime(Windows)或 ~/.local/share/jupyter/runtime/(Linux/macOS)。直接改权限或删文件能临时绕过,但治标不治本;真正稳定的做法是让 Jupyter 别碰这些受限路径。
为什么 runtime 目录总报 Permission denied
Jupyter 启动时会在 runtime 目录下生成 jpserver-*.json、notebook_cookie_secret、jpserver-*-open.html 等临时文件。Windows 默认限制 AppDataRoaming 下的写入权限(尤其当用管理员账户安装、普通用户运行时),Linux/macOS 则可能因 ~/.local/share/jupyter 所有者错乱或 umask 设置过严导致失败。
- 错误日志里反复出现
Failed to write server-info to .../runtime/xxx.json或Writing notebook server cookie secret to .../runtime/notebook_cookie_secret——说明问题就卡在 runtime 目录 -
chmod 777或右键“属性→安全→赋予完全控制”看似有效,但下次系统更新或杀毒软件扫描后可能重置权限,不推荐长期使用 - 不要手动删除
runtime下的文件再重启——Jupyter 可能因残留锁文件或权限残留继续失败
用 jupyter_notebook_config.py 指定干净的工作目录
最稳妥的方式是把整个 Jupyter 的工作区(包括 notebook 存放位置和 runtime)挪到你有完全控制权的路径下,比如 D:jupyter 或 ~/jupyter-workspace。
- 先生成配置文件:
jupyter notebook --generate-config(默认生成在~/.jupyter/jupyter_notebook_config.py或%USERPROFILE%.jupyterjupyter_notebook_config.py) - 编辑该文件,取消注释并修改两行:
c.NotebookApp.notebook_dir = 'D:/jupyter'c.NotebookApp.runtime_dir = 'D:/jupyter/runtime' - 确保
D:/jupyter和D:/jupyter/runtime目录已存在,且当前用户对其有读写权限(Windows 上右键→属性→安全→编辑→勾选“修改”;Linux/macOS 执行chmod 755 D:/jupyter) - 重启 Jupyter:
jupyter notebook,此时所有文件都落在你可控的路径下,Permission denied基本消失
Windows 用户特别注意 AppDataRoamingjupyter 的所有权问题
如果坚持用默认路径,必须修复 %APPDATA%jupyter 的所有权——尤其当你用管理员身份装过 Anaconda,但日常用标准用户登录时。
- 打开文件资源管理器,导航到
C:Users\AppDataRoamingjupyter - 右键 → 属性 → 安全 → 高级 → 更改“所有者”为你当前用户名(不是 Administrators 组)
- 勾选“替换子容器和对象的所有者”,点击应用 → 确定
- 回到“安全”选项卡,点击“编辑” → 添加你的用户名 → 勾选“完全控制” → 应用
- 再删一次
runtime文件夹(不是单个文件),重启 Jupyter
Linux/macOS 上检查 ~/.local/share/jupyter 的归属和权限
常见错误是 jupyter 目录被 root 创建(比如用 sudo pip install jupyter),导致普通用户无权写入。
- 运行
ls -ld ~/.local/share/jupyter,确认输出中 owner 是你自己的用户名,不是root - 如果是 root 所有:执行
sudo chown -R $USER:$USER ~/.local/share/jupyter - 再运行
chmod -R u+rw ~/.local/share/jupyter确保用户有读写权 - 若仍失败,可临时用
jupyter notebook --allow-root启动验证是否为权限问题(仅调试用,不建议长期启用)
runtime_dir 和 notebook_dir 分开指定是关键。很多人只改了 notebook_dir,却没动 runtime_dir,结果 notebook 能存,但启动时仍卡在写 cookie 或 server-info 上——那个 runtime 目录才是真正的雷区。











