command_line_usage

命令行用法

虽然 JupyterLab 和 Jupyter Notebook 提供了丰富的基于 Web 的界面，您也可以使用命令行选项直接从终端与 IPython 交互并管理 Jupyter 组件。

启动 IPython

要启动增强型 IPython 终端会话，只需输入：

ipython

您还可以直接执行脚本或命令：

• ipython my_script.py: 执行脚本并退出。
• ipython -i my_script.py: 执行脚本后，进入一个交互式 IPython 会话，并加载了脚本的命名空间。
• ipython -c "print('Hello'); import numpy as np; print(np.__version__)": 执行给定的命令字符串。
• ipython -m my_module: 将库模块作为脚本运行（类似于 python -m）。

启动 JupyterLab

要启动现代的 JupyterLab 界面：

jupyter lab

常用选项包括：

• --no-browser: 启动服务器但不自动打开 Web 浏览器。
• --port=XXXX: 指定使用的端口号（默认是 8888）。
• --ip=0.0.0.0: 使服务器可以从网络上的其他机器访问（请谨慎使用，考虑安全隐患，例如设置密码）。
• --notebook-dir=/path/to/start: 指定文件浏览器的根目录。
• --ServerApp.token='' 和 --ServerApp.password='' : 禁用令牌认证（在安全环境中或使用其他认证方法，如 JupyterHub 时很有用）。

# 在端口 9999 启动 JupyterLab 但不打开浏览器
jupyter lab --no-browser --port=9999

启动 Jupyter Notebook（经典版）

要启动经典的 Jupyter Notebook 界面：

jupyter notebook

它接受许多与 jupyter lab 相同的选项（例如 --no-browser, --port, --ip, --notebook-dir）。

管理内核和配置文件 (IPython)

IPython 提供了用于管理其配置的子命令：

• ipython profile create <profilename>: 创建一个新的配置文件。
• ipython profile list: 列出可用的配置文件。
• ipython locate: 显示 IPython 配置目录的路径。
• ipython locate profile <profilename>: 显示特定配置文件的路径。
• ipython kernel install [--user] [--name=<kernelname>] [--display-name=<displayname>]: 为当前环境安装一个内核规范，使其在 Jupyter 中可用。
• jupyter kernelspec list: 列出所有已安装的 Jupyter 内核。

# 为项目 'myproj' 创建一个配置文件
ipython profile create myproj

# 使用此配置文件启动 ipython
ipython --profile=myproj

# 将当前的 python 环境安装为一个名为 'py310-myenv' 的内核
jupyter kernel install --user --name=py310-myenv --display-name="Python 3.10 (My Env)"

其他有用的命令

• jupyter --paths: 显示各种 Jupyter 配置和数据路径。
• jupyter nbconvert: 将 Notebook 转换为其他格式（HTML, PDF, Python 脚本等）。jupyter nbconvert --to script my_notebook.ipynb
• jupyter run my_notebook.ipynb: 从命令行运行 Notebook。
• jupyter console: 启动一个基于终端的 Jupyter 控制台，连接到内核。
• jupyter qtconsole: 启动一个更丰富的基于 Qt 的 Jupyter 控制台。

请参阅每个命令的帮助选项（例如 ipython --help, jupyter lab --help, jupyter nbconvert --help），查看所有可用选项和子命令的完整列表。