REPL

入门

将 Jupyter 内核的强大功能带到您的编辑器中！Zed 内置的 REPL 允许您在编辑器中以交互方式运行代码，类似于使用您自己的文本文件的笔记本。

安装

Zed 支持以多种语言运行代码。要开始使用，您需要为您要使用的语言安装一个内核。

目前支持的语言

• Python (ipykernel)
• TypeScript (Deno)
• R (Ark)
• R (Xeus)
• Julia
• Scala (Almond)

安装后，您可以在相应的语言文件中，或在支持这些语言的其他地方（例如 Markdown）开始使用 REPL。如果您最近添加了内核，请运行 repl: refresh kernelspecs 命令使其在编辑器中可用。

使用 REPL

要启动 REPL，请打开一个包含您要使用的语言的文件，并使用 repl: run 命令（在 macOS 上默认为 ctrl-shift-enter）运行一个块、选择或行。您也可以单击工具栏中的 REPL 图标。

repl: run 命令将在您的选择上执行，结果将显示在选择下方。

可以使用 repl: clear outputs 命令或工具栏中的 REPL 菜单清除输出。

单元格模式

Zed 支持使用 Python 中的 # %% 单元格分隔符和 TypeScript 中的 // %% 将 笔记本作为脚本。这允许您在一个文件中编写代码并将其作为笔记本运行，逐个单元格运行。

repl: run 命令将在 # %% 标记之间的每个代码块作为单独的单元格运行。

# %% Cell 1
import time
import numpy as np

# %% Cell 2
import matplotlib.pyplot as plt
import matplotlib.pyplot as plt
from matplotlib import style
style.use('ggplot')

语言特定说明

Python

全局环境

要设置您的当前 Python 以拥有可用的内核，请运行

pip install ipykernel
python -m ipykernel install --user

Conda 环境

source activate myenv
conda install ipykernel
python -m ipykernel install --user --name myenv --display-name "Python (myenv)"

带 pip 的虚拟环境

source activate myenv
pip install ipykernel
python -m ipykernel install --user --name myenv --display-name "Python (myenv)"

R (Ark 内核)

通过下载适用于您操作系统的发行版安装 Ark。例如，对于 macOS，只需解压 ark 二进制文件并将其放入 /usr/local/bin。然后运行

ark --install

R (Xeus 内核)

• 安装 Xeus-R
• 安装 Zed 的 R 扩展（在 Zed 扩展中搜索 R）

TypeScript: Deno

• 安装 Deno，然后安装 Deno jupyter 内核

deno jupyter --install

Julia

• 从 官方网站 下载并安装 Julia。
• 安装 Zed 的 Julia 扩展（在 Zed 扩展中搜索 Julia）

Scala

• 使用 cs setup (Coursier) 安装 Scala
  • brew install coursier/formulas/coursier && cs setup
• REPL (Almond) 安装说明
  • brew install --cask temurin (Eclipse 基金会官方 OpenJDK 二进制文件)
  • brew install coursier/formulas/coursier && cs setup
  • coursier launch --use-bootstrap almond -- --install

更改每种语言使用的内核

Zed 会自动检测您系统上可用的内核。如果您需要为某种语言配置不同的默认内核，可以在 settings.json 中为任何受支持的语言分配内核。

{
  "jupyter": {
    "kernel_selections": {
      "python": "conda-env",
      "typescript": "deno",
      "javascript": "deno",
      "r": "ark"
    }
  }
}

调试内核规范

可用的内核通过 repl: sessions 命令显示。要刷新您可以运行的内核，请使用 repl: refresh kernelspecs 命令。

如果您安装了 jupyter，可以运行 jupyter kernelspec list 查看可用的内核。

$ jupyter kernelspec list
Available kernels:
  ark                   /Users/z/Library/Jupyter/kernels/ark
  conda-base            /Users/z/Library/Jupyter/kernels/conda-base
  deno                  /Users/z/Library/Jupyter/kernels/deno
  python-chatlab-dev    /Users/z/Library/Jupyter/kernels/python-chatlab-dev
  python3               /Users/z/Library/Jupyter/kernels/python3
  ruby                  /Users/z/Library/Jupyter/kernels/ruby
  rust                  /Users/z/Library/Jupyter/kernels/rust

注意：Zed 尽力使用 sys.prefix 和 CONDA_PREFIX 在 Python 环境中查找内核。如果您希望明确控制，请在环境中运行时运行 python -m ipykernel install --user --name myenv --display-name "Python (myenv)" 直接安装内核。