PyCharm 2025.3 Help

管理 Jupyter 笔记本服务器

在 PyCharm 中,您可以使用以下服务器类型执行代码单元格:

  • 默认服务器 – 由 PyCharm 为当前项目自动启动的 Jupyter 服务器。 当您关闭 PyCharm 时,它将被终止。

  • 外部服务器 – 您通过指定其 URL 和令牌连接的任意 Jupyter 服务器。 它可以在您的本地或远程计算机上运行。

添加默认 Jupyter 服务器

  1. 转到 工具 | 添加 Jupyter 连接...

    或者,右键点击项目目录,并从上下文菜单中选择 新建 | Jupyter 连接

  2. 在打开的窗口中,点击 添加 Jupyter 连接添加配置 ,或按 Alt+Insert 并选择 添加默认

    有关配置默认服务器的更多信息,请参阅 设置默认服务器

  3. 如果您希望为当前笔记本自动选择新创建的服务器,请点击 应用

    或者,点击 确定 以在不选择新服务器的情况下保存更改。

添加默认 Jupyter 服务器

添加外部 Jupyter 服务器

  1. 转到 工具 | 添加 Jupyter 连接...

    或者,右键点击项目目录,并从上下文菜单中选择 新建 | Jupyter 连接

  2. 在打开的窗口中,点击 添加 Jupyter 连接添加配置 ,或按 Alt+Insert 并选择 添加外部

    有关配置外部服务器的更多信息,请参阅 设置外部服务器

  3. 如果您希望为当前笔记本自动选择新创建的服务器,请点击 应用

    或者,点击 确定 以在不选择新服务器的情况下保存更改。

添加 Jupyter 服务器

设置默认服务器

  1. 点击 Jupyter 笔记本工具栏 上的服务器列表,并从上下文菜单中选择 配置 Jupyter 服务器

    配置 Jupyter 服务器
  2. 在打开的窗口中,选择 默认 (自动启动) 服务器。

  3. 使用 命令行参数 字段设置服务器参数。

  4. 设置 环境变量 并为其指定值。

  5. Jupyter 服务器可以通过令牌(包含在 URL 中)或用户自定义的密码进行保护。 如果 Jupyter 服务器通过密码进行保护,请在 密码 字段中输入该密码。

    有关更多信息,请参阅 Jupyter 笔记本服务器中的安全性

  6. 点击 确定 以应用更改并关闭窗口,或点击 应用 以保持窗口打开。

设置托管服务器

设置外部服务器

  1. 点击 Jupyter 笔记本工具栏 上的服务器列表,并从上下文菜单中选择 配置 Jupyter 服务器

    配置 Jupyter 服务器

    或者,在项目视图 Alt+1 中右键点击该服务器,并从上下文菜单中选择 配置 Jupyter 服务器

  2. 在打开的窗口中,选择您要配置的外部服务器。

  3. 名称 字段中,为您的外部服务器设置名称。

  4. 服务器 URL 字段中,指定用于与外部 Jupyter 服务器建立连接的地址。 目标 URL 应包含服务器名称或其地址,以及访问令牌。

    或者,点击 发现本地服务器 ,以自动检测本地计算机上的可用 Jupyter 实例。 如果找到服务器,URL 和令牌将自动填充。

  5. 类型 下,选择所需的服务器类型。

    使用此选项连接到标准的 Jupyter NotebookJupyterLab 实例,可在本地或远程计算机上运行。

    提供所需的身份验证令牌或密码。

    Notebook/Lab

    使用此选项连接到 JupyterHub 实例。

    提供以下之一:

    • 如果通过登录凭据进行身份验证,请提供您的用户名、密码以及 Hub 的 URL。

    • 如果使用基于令牌的身份验证,请提供包含访问令牌的正在运行的 Jupyter 笔记本服务器的直接 URL。

    Hub

    使用此选项连接到 AWS SageMaker 实例或其他云解决方案。

    不需要令牌,您可以直接使用预签名 URL。

    AWS SageMaker
  6. 如果服务器需要代理连接,请选中 使用 IDE 代理 复选框。

    请参阅 HTTP 代理 页面以配置相应设置。

  7. 点击 测试连接 以验证设置。

  8. 点击 确定 以应用更改并关闭窗口,或点击 应用 以保持窗口打开。

设置已配置的服务器

管理外部服务器文件

当外部 Jupyter 服务器连接后,其文件会显示在 项目视图 中。 您可以在外部 Jupyter 服务器上创建、打开、编辑和删除文件,就像它们是本地项目的一部分一样。 例如:

  • 要添加文件,请右键点击外部服务器目录或其中的包,并从上下文菜单中选择 新建。 选择所需的文件类型。

    有关详细信息,请参阅 创建新文件

    添加远程服务器文件
  • 要删除文件,请在外部服务器目录中右键点击它,并从上下文菜单中选择 删除 Delete

    删除远程服务器文件

    移除 Jupyter 服务器

    • 转到 设置 | Jupyter | Jupyter 服务器

      在打开的窗口中,选择您要移除的服务器,然后点击 移除配置移除配置 ,或按 Delete

      移除 Jupyter 服务器
    • 或者,要移除外部服务器,请在项目视图 Alt+1 中右键点击该服务器,并从上下文菜单中选择 删除 Delete

    启动本地 Jupyter 服务器

    1. 点击 Jupyter 笔记本工具栏上的服务器列表,并从上下文菜单中选择您要启动的服务器。

    2. 要运行 Jupyter 服务器, 执行任意代码单元格。 当您启动单元格执行时,PyCharm 会在本地主机上使用任意可用端口启动 Jupyter 服务器(默认端口为 8888)。 您可以切换到 Jupyter 服务器 工具窗口以预览服务器的配置详细信息。

    Jupyter 服务器正在运行。 Jupyter 工具窗口

    停止 Jupyter 服务器

    要停止任何正在运行的服务器,请切换到 Jupyter 服务器 工具窗口并点击 停止 Jupyter 服务器停止 Jupyter 服务器。 在 服务器日志 窗口中预览状态。

    正在停止服务器

    关闭服务器后,当前会话将被终止。 下次启动该服务器时,所有先前会话及所有笔记本的执行结果都将丢失。

      内核操作

      重启内核

      您可能希望在不关闭整个服务器且不影响其他笔记本的情况下刷新计算。 要重启当前正在运行的内核,请在 Jupyter 笔记本工具栏 上点击 内核。 然后,您可以在 服务器日志 窗口中查看内核状态:

      正在重启当前内核

        关闭内核

        要完全停止正在运行的内核,请打开 Jupyter 笔记本工具栏上的服务器列表,并从上下文菜单中选择 关闭内核。 此操作将终止当前内核会话。

        关闭内核

          切换内核

          如果至少有两个可用内核,并且需要切换到其他内核,请打开 Jupyter 笔记本工具栏上的服务器列表。 从上下文菜单中选择 切换内核 ,并在下拉列表中选择所需的内核。

          切换内核

            将内核连接到服务器

            选择远程 Jupyter 服务器并打开笔记本后,在首次运行单元格后,内核列表会自动可用。

            不过,您也可以在运行任何单元格之前手动连接到该服务器。 添加外部服务器后,请在 Jupyter 笔记本工具栏 上点击 连接到服务器 按钮。 这将建立内核与 Jupyter 服务器之间的连接。

            将内核连接到服务器
              最后修改日期: 2025年 12月 2日