- 准备工作：下载安装包
- 开始安装：一步步引导
- 配置首次启动（可选但推荐）
- 启动与验证
- 常见问题与解决方法
第一步：准备工作：下载安装包
在安装之前，你需要确保你的电脑满足基本要求,并下载正确的安装文件。
系统要求
- 操作系统：Windows 10 或更高版本。
- 内存：至少 4GB RAM，推荐 8GB 或以上。
- Java 环境：这是最关键的一点！ SQL Developer 是一个 Java 应用程序，它需要一个 Java 运行环境 来运行。
- 注意：从 SQL Developer 21.2 版本开始，安装程序会自动捆绑一个 JDK（Java Development Kit），你无需手动安装 Java。
- 如果你使用的是 21.2 之前的版本，则需要手动安装 JDK 并配置环境变量。本教程以最新的自动捆绑 JDK 的版本为例，所以你可以跳过手动安装 Java 的步骤。
下载 SQL Developer
-
打开浏览器，访问 Oracle 官方下载页面： https://www.oracle.com/database/technologies/appdev/sqldeveloper.html
-
在页面中找到 "Download" 按钮,点击进入下载页面。
-
你会看到几个下载选项，对于大多数用户,请选择：
- "Download for Windows x64"：这是 64 位 Windows 系统的安装包，文件名通常以
sqldeveloper-*-*-no-jdk.zipno-jdk表示它不包含JDK，需要你手动配置，为了方便，我们推荐下载包含 JDK 的版本。
- "Download for Windows x64"：这是 64 位 Windows 系统的安装包，文件名通常以
-
如何找到包含 JDK 的版本？
（图片来源网络，侵删）- 在下载列表中，寻找文件名包含
with-jdk的 zip 文件，sqldeveloper-23.2.0.234.2340-no-jdk.zip(不带 JDK) 和sqldeveloper-23.2.0.234.2340-with-jdk-23.0.1.zip(带 JDK)。 - 强烈建议下载
with-jdk版本，这样可以避免后续配置 Java 环境的麻烦。
- 在下载列表中，寻找文件名包含
-
同意许可协议，然后点击下载链接，文件较大（约 1GB 左右）,请耐心等待下载完成。
第二步：开始安装：一步步引导
SQL Developer 的安装非常简单，它本质上是一个“解压即用”的程序,但官方提供了一个安装向导来帮助你完成配置。
使用官方安装向导（推荐）
-
找到你下载好的
.zip文件（sqldeveloper-23.2.0.234.2340-with-jdk-23.0.1.zip），不要直接解压，而是右键点击它，选择 “全部解压缩...” (Extract All...)。 -
在解压向导中，选择一个目标路径（
D:\Oracle\sqldeveloper），然后点击“提取”,这会创建一个包含所有文件的文件夹。
（图片来源网络，侵删） -
进入解压后的文件夹，找到名为
sqldeveloper.exe的可执行文件，双击运行它。 -
官方的安装向导会启动，点击 "Next"。
-
选择 JDK：
- 由于我们下载的是
with-jdk版本，向导会自动检测到捆绑的 JDK 路径（D:\Oracle\sqldeveloper\jdk）,它会默认选中这个路径。 - 保持默认选择，点击 "Next"，如果你手动安装了其他 JDK,也可以在这里选择那个路径。
- 由于我们下载的是
-
选择 IDE 主目录：
- 这是指定 SQL Developer 配置文件存放位置的地方，通常保持默认即可，它会指向你解压的根目录（
D:\Oracle\sqldeveloper）。 - 点击 "Next"。
- 这是指定 SQL Developer 配置文件存放位置的地方，通常保持默认即可，它会指向你解压的根目录（
-
创建快捷方式：
- 勾选 "Create a Desktop Shortcut"（创建桌面快捷方式）和 "Create a Start Menu Shortcut"（创建开始菜单快捷方式）,方便以后启动。
- 点击 "Next"。
-
准备安装：
检查摘要信息，确认无误后，点击 "Install" 开始安装。
-
安装完成：
安装向导会提示安装完成，点击 "Finish"。
手动解压（更简单）
如果你不想使用安装向导，也可以手动完成,这在技术上是一样的。
-
将下载的
.zip文件解压到一个你喜欢的位置，D:\Oracle\sqldeveloper。 -
进入解压后的文件夹，直接双击
sqldeveloper.exe即可启动程序。
优点：速度极快，没有多余的步骤。 缺点：不会自动创建桌面快捷方式,需要你手动创建。
第三步：配置首次启动（可选但推荐）
第一次启动时，SQL Developer 可能会提示你进行一些基本设置。
-
检查更新：启动后，它会弹出一个窗口询问是否要检查更新，你可以选择 "Check for Updates" 或 "Skip and Check Later"，通常可以直接跳过,因为新版本刚下载下来就是最新的。
-
设置内存（重要！）：
- 如果你的电脑内存较大（16GB 或以上），可以分配更多内存给 SQL Developer,以提高处理大数据时的性能。
- 关闭 SQL Developer。
- 用记事本打开
sqldeveloper\sqldeveloper.conf文件。 - 找到类似
AddVMOption -Xms256m和AddVMOption -Xmx768m的行。-Xms是初始堆内存大小。-Xmx是最大堆内存大小。
- 你可以适当增加
-Xmx的值，例如改为-Xmx2048m(2GB) 或-Xmx4096m(4GB)。不要设置得过高，以免占用系统全部内存导致卡顿。
-
设置 JDK 路径（如果未使用安装向导）：
- 如果你是手动解压且没有使用安装向导，你需要手动指定 JDK 路径。
- 用记事本打开
sqldeveloper\ide\bin\product.conf文件。 - 找到
oracle.jdk.path这一行，将其值修改为你 JDK 的安装路径，oracle.jdk.path=D:/Java/jdk-17.0.2(注意路径分隔符用 或\\)。
第四步：启动与验证
一切准备就绪！
-
启动：双击桌面上的快捷方式，或者在解压文件夹中双击
sqldeveloper.exe。 -
首次运行：
- 首次启动可能需要一些时间来初始化。
- 它会提示你选择一个默认的 IDE 主题（亮色/暗色）,选择你喜欢的即可。
- 它会进入主界面。
-
连接数据库（验证安装是否成功）：
- 在左侧的 "Connections"（连接）窗口，点击左上角的 号。
- 在弹出的 "New/Select Database Connection" 窗口中：
- Connection Name：给你的连接起个名字，"My Local DB"。
- Username：输入数据库用户名，
system。 - Password：输入该用户的密码。
- Connection Type：通常选择 "Basic"。
- Role：默认是 "Default"。
- Connection Identifier：
host:port/service_name。- 本地 Oracle Express Edition (XE)：通常是
localhost:1521/XE。 - 本地 Oracle 19c/21c：通常是
localhost:1521/ORCLCDB或localhost:1521/FREE(取决于你的安装)。 - 远程数据库：填写服务器的 IP 和对应的端口及服务名。
- 本地 Oracle Express Edition (XE)：通常是
- 点击 "Test" 按钮，如果连接成功，会显示 "Status: Success"。
- 最后点击 "Connect"。
-
成功标志：
- 如果连接成功，你就可以在左侧看到你的连接名，展开后可以看到该用户下的所有表、视图等对象。
- 在右侧的 SQL 工作表中，你可以输入
SELECT * FROM V$VERSION;然后按F5或点击 "Run Script" 按钮，如果能成功查询并显示数据库版本信息，那么恭喜你，SQL Developer 已经完全安装并配置成功了！
