jshell 报错或异常的根本原因是未正确配置 jdk 9+ 环境、终端兼容性差、语句语法错误、会话不持久及作用域规则误解；需检查 jdk 版本与 path、换终端、补分号、用 /save 和 .jshelldesc 持久化、遵循其编译与作用域特性。
启动 JShell 报错 No Java runtime present 或找不到命令
根本原因通常是系统 PATH 没指向 JDK 9+ 的 bin 目录，或者安装的是 JRE 而非 JDK。JShell 是 JDK 自带工具，JRE 完全不包含它。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 运行
java -version确认输出中包含jdk字样且版本 ≥ 9（如17.0.1、21） - 检查
which jshell（macOS/Linux）或where jshell（Windows），若无输出，说明未加入 PATH - 手动进入 JDK 安装路径下的
bin目录（例如/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home/bin），直接执行./jshell - Mac 用户注意：如果用 Homebrew 安装过多个 JDK，需用
sudo ln -sf /opt/homebrew/opt/openjdk@17/bin/jshell /usr/local/bin/jshell软链到常用路径
JShell 启动后立即退出或卡在空白行
常见于 Windows 上 CMD 或 PowerShell 启动时编码不兼容，或终端不支持 ANSI 控制序列（比如某些老旧终端、IDE 内置终端）。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 优先换用
Windows Terminal或Git Bash，避免用原生 CMD - 启动时加参数禁用颜色和高级提示：
jshell --no-startup --no-env --color=never - 若仍卡住，尝试
jshell -v查看详细日志，重点观察是否报Unable to initialize jline terminal - IntelliJ 用户：不要在 IDE 的 Terminal 标签页里启动 JShell；改用
Tools → JShell Console（该功能专为 IDE 环境适配过）
输入 System.out.println("hello") 没输出，或提示 | Error:
JShell 默认启用“表达式模式”，但 System.out.println(...) 是语句（statement），不是纯表达式（expression）。直接敲会报错或静默失败。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 语句必须以分号结尾：
System.out.println("hello");—— 少了分号就解析失败 - 也可以省略分号，改用表达式写法：
"hello"会自动打印，但这是字符串字面量，不是调用 - 定义变量时别漏掉类型或用
var：var msg = "hello";合法，msg = "hello";会报unknown variable - 想执行多行代码？用
/edit命令唤出编辑器，或按Ctrl+Shift+Enter（Windows/Linux）或Cmd+Shift+Enter（Mac）换行继续输入
退出 JShell 后历史记录丢失，或想复用上次的变量
JShell 默认不持久化会话状态。每次重启都是干净环境，之前定义的 var、方法、导入全清空。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 保存当前会话：
/save my-session.jsh，下次用jshell my-session.jsh加载 - 想自动加载常用导入？创建
~/.jshelldesc（Linux/macOS）或%USERPROFILE%\.jshelldesc（Windows），每行写一个import，如import java.time.*; - 注意：
/save不保存变量值，只保存源码；如果变量依赖外部类或尚未编译的代码，加载后可能报错 - 调试时别依赖历史——JShell 的
/history只在当前会话有效，关掉终端就没了
真正容易被忽略的是：JShell 不是 REPL 的“简化版”，它有自己的一套作用域规则和编译时机。比如方法定义后不能直接修改签名，得用 /drop 删除再重写；又比如泛型推导在 JShell 里比编译器宽松，但上线前务必在真实 javac 下验证。别让它骗你。
