Skip to content

configuring_ipython_jupyter

虽然 IPython 和 Jupyter 的默认设置对于大多数用例而言已经非常出色,但你可能希望定制环境,例如在每次启动会话时自动导入常用模块或设置特定配置。

IPython 提供了一种简单的方法,使其在每次启动时(包括作为 Jupyter 内核启动时)都能运行自定义 Python 代码。你可以将 Python 脚本 (.py) 或 IPython 脚本 (.ipy) 放置在 IPython 的启动目录中。

首先,找到你的 IPython 配置文件目录。默认配置文件通常命名为 profile_default。你可以使用以下命令找到 IPython 目录:

ipython locate

在此目录下,导航到 profile_default/startup/ 文件夹(如果不存在则创建)。放置在此处的任何 .py 或 .ipy 文件将在 IPython 启动时按顺序执行。

例如,创建一个名为 ~/.ipython/profile_default/startup/00-imports.py 的文件,其内容如下,用于自动导入 NumPy 和 Pandas:

import numpy as np
import pandas as pd
print("NumPy 和 Pandas 已自动导入。")

现在,无论何时你使用此配置文件启动 IPython 或 Jupyter 内核,np 和 pd 都将可用。

对于更复杂的配置,IPython 使用配置文件(例如,ipython_config.py)。你可以使用以下命令生成默认配置文件:

ipython profile create # 如果默认配置文件不存在则创建
ipython profile locate default # 显示默认配置文件的路径
# 现在编辑该目录下的 ipython_config.py

在 ipython_config.py 文件中,你可以取消注释并修改各种设置。例如,要关闭自动缩进设置:

c = get_config()
# 关闭自动缩进
c.TerminalInteractiveShell.autoindent = False

类似地,Jupyter 组件,如 Notebook 服务器,也有自己的配置文件(例如,jupyter_notebook_config.py 或较新版本的 jupyter_server_config.py)。使用以下命令生成并找到它:

jupyter notebook --generate-config # 或 jupyter server --generate-config

你可以在此文件中配置默认端口、浏览器行为、密码保护等选项。

对于像导入这样的简单定制,通常推荐使用启动文件,而配置文件则提供了对 IPython 和 Jupyter 行为更精细的控制。

注意:虽然设置 PYTHONSTARTUP 环境变量(如在旧指南中提及)可以在启动标准 Python 解释器时执行脚本,但与使用配置文件启动文件或配置文件相比,它较少用于定制 IPython/Jupyter 环境。