Jupyter CLI参数正确用法:如何修改内核连接文件名?
解决Jupyter Kernel指定连接文件名不生效的问题
你遇到的问题其实是Jupyter路径机制的一个常见“小坑”,核心是两个容易忽略的细节:
1. 默认路径的隐藏规则
Jupyter内核的连接文件默认会生成在系统指定的runtime目录,而非你当前打开终端的工作目录,不同系统的路径如下:
- Linux:
~/.local/share/jupyter/runtime/ - macOS:
~/Library/Jupyter/runtime/ - Windows:
%APPDATA%\jupyter\runtime\
你执行jupyter kernel --KernelManager.connection_file='test-this-thing.json'后,内核确实生成了这个文件,但它被放到了上述默认目录里,所以你误以为参数没生效。
2. 正确指定路径的方法
如果想让连接文件生成在你期望的位置(比如当前工作目录),必须明确指定相对路径或绝对路径,不能只写文件名:
示例命令
# 在当前工作目录生成connection.json jupyter kernel --KernelManager.connection_file=./connection.json # Linux/macOS绝对路径示例 jupyter kernel --KernelManager.connection_file=/home/yourname/notebooks/connection.json # Windows绝对路径示例 jupyter kernel --KernelManager.connection_file=C:\Users\yourname\notebooks\connection.json
执行完命令后,你就能在指定路径下找到对应的连接文件了。
验证小技巧
如果想确认默认runtime目录位置,可以执行以下命令查看Jupyter的所有默认路径:
jupyter --paths
输出中的runtime字段就是默认连接文件存放目录,你可以去那里检查之前生成的test-this-thing.json是否存在。
内容的提问来源于stack exchange,提问作者Daniel




