Oracle SQL Developer 在 macOS 启动失败需手动指定 Oracle JDK 11 路径，不兼容 OpenJDK（缺 JavaFX），Apple Silicon 必须用 ARM64 版本，并正确配置 sqldeveloper.conf 或命令行参数。
Oracle SQL Developer 在 macOS 上启动失败，八成是 JDK 路径没配对或版本不兼容——它不读 JAVA_HOME，也不认 OpenJDK 缺 JavaFX 的构建，必须手动指定 Oracle JDK 11 的完整路径。
启动报 “No Java runtime present” 怎么修
这是 macOS 用户最常遇到的卡点：双击图标直接无响应，或者弹窗报错。根本原因不是没装 JDK，而是 SQL Developer 启动脚本压根不查系统环境变量，且对 JDK 构建有硬性要求。
- 必须用 Oracle 官方 JDK 11（如
jdk-11.0.21.jdk），别用 OpenJDK 二进制包（缺javafx模块会导致界面白屏或崩溃） - macOS 上典型路径是：
/Library/Java/JavaVirtualMachines/jdk-11.0.21.jdk/Contents/Home - 编辑
sqldeveloper/bin/sqldeveloper.conf，取消注释并改写这一行：SetJavaHome /Library/Java/JavaVirtualMachines/jdk-11.0.21.jdk/Contents/Home - 改完必须彻底退出 SQL Developer（包括菜单栏图标右键「退出」），再重新双击启动，改配置不重启无效
Apple Silicon（M1/M2）用户该选哪个安装包
官网提供两个 macOS 版本，选错会直接闪退或界面模糊：
- Intel 芯片选
Mac OSX with JDK 11 included（内置 JDK，开箱即用） - M1/M2 芯片必须选
Mac ARM64 with JDK 11——这是专为 Apple Silicon 编译的原生版本，非 Rosetta 模拟运行 - 如果已下载 Intel 版却在 M 系列 Mac 上运行，会出现 CPU 占用高、窗口拖拽卡顿、字体渲染异常等问题
免安装版（解压即用）怎么指定 JDK
绿色版看似方便，但 JDK 绑定更严格：它连 sqldeveloper.conf 都不读，只能靠命令行参数硬指定。
- 终端进入解压目录，执行：
./sqldeveloper.sh -J-Djava.home="/Library/Java/JavaVirtualMachines/jdk-11.0.21.jdk/Contents/Home" - 路径中不能含空格或中文（比如
/Users/张三/Downloads必须改成/opt/sqldev） - 若仍报错，检查 JDK 是否真的包含
lib/javafx.base.jar——Oracle JDK 11 安装包自带，多数 OpenJDK 构建不带
连接 Oracle 数据库时 TNS 名称不识别
SQL Developer 默认用 JDBC Thin 驱动，不依赖本地 Oracle 客户端，所以 tnsnames.ora 文件默认无效。要连私有网络里的数据库，得手动填连接串。
- 新建连接时，选择「Basic」类型，而非「TNS」
- Host 填 IP 或域名，Port 填
1521（或实际监听端口），SID 填服务名（如XE或ORCLCDB） - 如果用 Docker 启的 Oracle XE（如
gvenzl/oracle-xe:21-slim），服务名通常是XEPDB1，不是XE - 想用
tnsnames.ora？得切到「Advanced」连接类型，粘贴完整 TNS 描述符，或把文件路径填进「TNS Directory」字段
真正麻烦的不是装不上，而是装上了但连不上、连上了但 dbms_output.put_line 不输出、输出了但中文乱码——这些全和 JDK 字符集、JDBC 驱动参数、甚至 macOS 终端区域设置隐式相关，得一个个抠。
