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 的 Virtualenv

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

R (Ark Kernel)

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

ark --install

R (Xeus Kernel)

• 安装 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"
    }
  }
}

调试 Kernelspecs

可通过 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)" 以在环境中直接安装内核。