五分钟上手

挑一种装法，然后跑你的第一个程序。

一、选一种装法

① Windows 安装程序（最省事）

下载 jishi-0.2.6-windows-x64-setup.exe 双击装。 不用先装 Python —— 发行包自带运行时；用户级安装、免管理员， 向导是中文的。

去下载（本站，大陆直连）→ 　另有免安装的 .zip，旧版本在下载页的版本历史里。

② Linux / macOS 压缩包

解压后跑 install.sh。Linux 是 x64；macOS 目前只有 Apple 芯片（arm64）版，没有 Intel 版。

tar -xzf jishi-<版本>-linux-x64.tar.gz
cd jishi-<版本>-linux-x64 && bash install.sh

③ 从源码构建（给要改语言本身的人）

正式实现是 Rust，构建只要 cargo。这不是安装方式 —— Python 那套 实现已退役，没有 pip install 入口了。

git clone https://github.com/benxiaoniao/JISHI.git
cd JISHI/rust && cargo build --release

⚠️ 这条路要连 GitHub，大陆可能很慢甚至超时。

④ 什么都不装

用在线试玩 —— 浏览器里直接写、直接跑， 引擎跑在页面上。

适合：先看看这东西长什么样。

想在 VS Code 里写？扩展市场搜 jishi，装 jishi-lang.vscode-jishi：语法高亮、补全、跳转、调试器都有。 ⚠️ 但扩展不带运行时 —— 要先按上面 ①②③ 任意一种把 jishi 命令装好，扩展才跑得起来（它默认调 PATH 上的 jishi，也可以在设置里指到别处）。

装完先跑一次 jishi 医生：它会查版本、引擎与可执行文件位置、 在不在 PATH 上、包目录、终端编码，以及包索引通不通（装第三方包要用这一步）。 哪一步有问题，它会直接说怎么修。

二、第一个程序

新建 你好.jsh，写三行：

令 名字 = "世界"
打印("你好，" + 名字 + "！")

然后：

jishi 你好.jsh
应该看到这一行你好，世界！

文件后缀是 .jsh，用 UTF-8 保存。 在 Windows 记事本里存成别的编码，中文会乱码（和 Python 2 时代一个道理）。

三、一步一步来

下面五段都可以直接存成文件跑，每段只加一个新东西。

1. 变量与运算

令 单价 = 12.5
令 数量 = 3
打印(单价 * 数量)

2. 判断

令 分数 = 87
如果 分数 >= 90：
    打印("优秀")
否则如果 分数 >= 60：
    打印("及格")
否则：
    打印("不及格")

3. 循环

遍历 数 在 范围(1, 6)：
    打印(数, "的平方是", 数 * 数)

4. 函数

函数 算面积(长, 宽 = 1)：
    返回 长 * 宽

打印(算面积(5, 3))
打印(算面积(4))

5. 字典（键值对）

令 库存 = {"苹果": 12, "香蕉": 7}
库存["苹果"] = 库存["苹果"] - 2
遍历 名字, 数量 在 库存.项目()：
    打印(名字, "还剩", 数量)

四、中文编程会遇到的坑

① 标点必须是半角的。中文输入法打出的 （ ） ， 和英文的 ( ) , 长得像，但机器只认后者。基石会直接报「无法识别的字符」并指出那一列 —— 这是新手中招最多的一条。

② 冒号「：」在句尾是全角的。这是唯一一处故意的全角 —— 因为它读起来是中文的一部分（如果 真：）。

③ 缩进用空格，一级四个。不要混用 Tab 和空格（会用 jishi 格式化 文件.jsh -w 一键修好）。

④ 关键字后面要有空格。如果真： 会被读成一个名字 如果真，要写成 如果 真：。

五、出错了怎么办

基石报错会尽量把「错在哪、错什么、怎么改」一次说清：

错误 E0301：找不到这个名字（找不到名字「长渡」）
  ┌─ 你好.jsh:2:6
  │
  2 │ 打印(长渡([1]))
    │      ^
  │
  提示：你是不是想写「长度」？

报错里的错误码可以直接查：

jishi 错误 E0301

每个码都会给出「什么意思 / 常见成因 / 怎么改」三段。全部 32 个码用 jishi 错误 列出来。

接下来看什么