本文为VSCode用户提供Oracle SQL Developer的快速入门指南。核心要点工作流程对比连接数据库类似打开项目→编写SQLSQL工作表替代编辑器→运行调试专用DBMS_OUTPUT面板关键操作必须手动开启DBMS_OUTPUT面板才能查看调试输出通过View→DbmsOutput菜单激活后需点击绿色加号绑定当前连接调试技巧存储过程开发支持完整断点调试可调整缓冲区大小解决输出截断问题与VSCode对照连接导航器文件资源管理器SQL工作表编辑器终端集成数据库对象代码文件典型问题解决方案若put_line()无输出需检查是否完成「开启面板绑定连接」两个必要步骤。Oracle SQL Developer 使用指南类比 VS Code从VSCode转向Oracle SQL Developer第一反应可能是“这个界面怎么有点老派”。但别担心它和VSCode本质上是相通的——都是围绕“连接资源 → 编写代码 → 运行调试”这个核心循环。最大的不同在于SQL Developer是专门为数据库开发设计的工作流程完全是“数据库驱动”的。这是一份专门为你准备的快速上手指南我会用VSCode的逻辑来类比帮你快速理解它的核心玩法和运行逻辑。 核心工作流程连接 → 编写/操作 → 运行/调试无论是管理数据还是写存储过程都遵循这个标准流程建立连接 (Connect)告诉工具要连哪个数据库。浏览/操作对象 (Navigate/Manipulate)在左侧导航栏找到表、视图、存储过程等。编写/执行 (Write/Execute)在右侧的SQL工作表中写代码并执行。调试/优化 (Debug/Tune)调试存储过程或分析SQL性能。 第一步建立数据库连接 (就像打开一个新的VSCode项目)在VSCode里你首先要“打开文件夹”才能开始写代码。在SQL Developer里第一步就是建立一个数据库连接告诉工具你要连到哪个具体的数据库。你需要点击左上角的绿色加号然后填写以下关键信息选项值/说明类比Connection Name随便起个好记的名字比如My_Dev_DB项目名Username / Password数据库的用户名和密码登录凭据Hostname数据库服务器的IP或地址服务器地址Port默认通常是1521端口号SID / Service Name你要连的那个具体数据库的唯一标识符具体的仓库名填好后点击Test测试一下看到左下角状态为Success就表示成功了然后保存并连接。小贴士别忘了你现在还有一个杀手锏——Oracle SQL Developer for VS Code 插件。如果你实在离不开VSCode可以直接在VSCode的扩展市场搜索安装它体验会平滑很多。SQL Developer 连接类型 (Connection Type) SID 和 Service Name的区别 第二步编写和执行代码 (SQL 工作表 ≈ 编辑器 终端)成功连接后会自动打开一个SQL 工作表 (SQL Worksheet)。你可以把SQL 工作表理解为一个集成了终端的、语法高亮的 VSCode 编辑器。写SQL在编辑区直接写你的SELECT * FROM employees;。执行点击绿色“运行”按钮 (Run Script)相当于运行整个脚本文件结果会直接打印在下方Log面板。F9或点击“执行语句”按钮 (Execute Statement)执行光标所在的那一条SQL语句结果会以表格形式展示非常直观。导出结果查询出来的结果表格你可以右键 - Export方便地导出为CSV、Excel或JSON格式。️ 第三步管理数据库对象 (就像浏览文件树)SQL Developer 左侧的连接导航器 (Connection Navigator)就相当于 VSCode 的文件资源管理器。不过这里显示的“文件”非常特别它们是数据库对象Tables (表)存储数据的根本。Views (视图)虚拟表通常是复杂查询的“快捷方式”。Procedures/Functions (存储过程/函数)运行在数据库内部的程序类似VSCode里编译好的后端脚本。Packages (包)一组相关的存储过程/函数的“文件夹”。Sequences (序列)自动生成递增数字的工具常用于主键ID。右键点击任何一个对象比如一张表你会看到一个强大的菜单可以对它进行新建、编辑、删除、查看数据等操作。 第四步开发和调试PL/SQL (存储过程编程)这是大数据开发需要重点关注的。Oracle的存储过程使用PL/SQL语言SQL Developer是官方最好的开发调试工具它的调试体验有点像VSCode的“Run and Debug”。创建右键点击Procedures节点选择New Procedure...填写过程名和参数点击OK一个代码模板就生成了。编写在模板的BEGIN ... END;之间填上你的业务逻辑。编译点击保存或编译图标过程就“构建”并部署到了数据库里。调试 (关键)先点击“编译为调试” (Compile for Debug)图标带一个小虫子的编译按钮。在你认为可能出问题的代码行左侧单击设置一个红点断点。点击“调试” (Debug)图标一个小虫子过程就会运行并在断点处暂停。你可以单步执行 (Step Into)并在“数据” (Data)标签页里实时查看和修改变量的值这对理解复杂的业务逻辑非常有帮助。⚡ VSCode vs. SQL Developer核心概念对照表为了让你更清晰地对比我用表格梳理了核心概念的异同核心概念VSCode (你的舒适区)Oracle SQL Developer (新地图)核心对象文件、文件夹表、视图、存储过程、函数、包等数据库对象工作区启动打开文件夹建立/打开数据库连接资源管理资源管理器连接导航器(层次结构更深)代码编辑编辑器 终端SQL 工作表(编辑器/SQL终端二合一)运行入口运行某个.py或.js文件运行一个SELECT语句或执行一个存储过程调试方式launch.json配置 VS Code Debugger右键存储过程 - Debug支持断点、单步、变量监控 总结作为前端转大数据的开发者你完全可以沿用VSCode的使用哲学来理解SQL Developer连接导航器是文件树SQL工作表是编辑器而所有开发工作都围绕“表”和“存储过程”这两个核心对象展开。上手的第一步是先成功连上一个数据库然后在SQL工作表中跑通一条SELECT语句。有了这个起点后续的探索会顺畅很多。使用 dbms_output.put_line() 找不到输出在哪只看到提示 PL/SQL 过程已成功完成。这个问题非常典型几乎所有第一次从SQL Worksheet执行PL/SQL的人都会遇到。关键在于DBMS_OUTPUT的输出不会自动显示你需要手动开启一个监听面板。 快速解决打开 DBMS_OUTPUT 面板在SQL Worksheet里你需要显式地打开输出面板查看菜单点击顶部菜单栏的View→Dbms Output激活监听在弹出的小面板上点击绿色的加号图标或者是一个带加号的数据库图标选择连接在弹出的窗口中选择你当前的数据库连接点击OK完成现在再执行你的BEGIN ... END;块输出就会显示在这个面板里了。记忆技巧可以把这个过程理解为——你写了一个console.log()但浏览器控制台没开。上面的操作就是在打开控制台绑定到当前页面。 详细步骤图解文字版第1步调出 Dbms Output 面板text菜单栏: View - Dbms Output面板通常会出现在下方区域和查询结果的Script Output、Results标签页在一起。第2步启用当前连接的输出监听在刚打开的空白 Dbms Output 面板上找到这个图标text[ ] 或 [绿色的数据库图标加号]点击它 → 选择你正在使用的数据库连接 → OK。第3步验证配置面板上会出现一行文字textConnected - [你的连接名]现在执行下面的测试代码sqlSET SERVEROUTPUT ON; -- 这行也可以不写但加上更保险 BEGIN DBMS_OUTPUT.PUT_LINE(Hello, 我是大数据开发!); END; /你会看到 Dbms Output 面板显示textHello, 我是大数据开发!⚠️ 常见坑点和补充说明问题现象原因解决方法只显示PL/SQL 过程已成功完成Dbms Output面板没打开或没连接完成上面的步骤1-2面板打开了但还是没输出忘了点击绿色加号选择连接每个连接需要单独绑定一次代码里写了SET SERVEROUTPUT ON也不行这个命令只是告诉SQL*Plus启用输出在SQL Developer里不是必须的但不能替代面板设置还是要打开Dbms Output面板能看到输出但内容不完整或被截断默认缓冲区可能不够在Dbms Output面板右上角点击设置图标增大Buffer Size比如设为50000 与VSCode开发经验的类比如果你用过VSCode调试Node.js这个逻辑其实很像VSCode场景SQL Developer场景你在代码里写console.log(xxx)你在PL/SQL里写DBMS_OUTPUT.PUT_LINE(xxx)你打开了调试控制台(Debug Console)才能看到输出你需要打开Dbms Output面板才能看到输出调试控制台默认是关闭的Dbms Output面板默认是隐藏的 进阶技巧让输出自动可见如果你不想每次都手动打开面板可以把这一步加到启动模板里打开任意SQL Worksheet点击工具栏的小扳手图标设置勾选Auto-open Dbms Output on execution自动打开输出面板这样每次执行包含DBMS_OUTPUT的代码块时面板会自动弹出。✅ 快速自检清单执行下面这段代码后检查清单sqlBEGIN DBMS_OUTPUT.PUT_LINE(测试输出); DBMS_OUTPUT.PUT_LINE(当前时间 || TO_CHAR(SYSDATE, YYYY-MM-DD HH24:MI:SS)); END; /View → Dbms Output菜单项是勾选状态吗Dbms Output 面板里显示 Connected - 你的连接名 吗如果都没问题但还是看不到尝试关闭Worksheet重新打开或重启SQL Developer完成这些步骤后你的DBMS_OUTPUT就能正常工作了。这是数据开发中调试存储过程、函数和触发器的核心技能值得花几分钟彻底搞明白。dbms_output.put_line()DBMS是Database Management System数据库管理系统的缩写。详细解释DBMS (Database Management System)全称Database Management System中文数据库管理系统定义用于创建、管理和操作数据库的软件系统常见的 DBMS 产品Oracle- Oracle 公司的关系数据库管理系统MySQL- 开源关系数据库管理系统SQL Server- Microsoft 的关系数据库管理系统PostgreSQL- 开源对象关系数据库管理系统DB2- IBM 的关系数据库管理系统在 Oracle 的语境中在您之前问的dbms_output.put_line()中dbms_output是 Oracle 中一个内置包Package的名称这个包名中的dbms正是取自Database Management System的缩写Oracle 中有很多以DBMS_开头的系统包例如DBMS_OUTPUT- 输出信息DBMS_SCHEDULER- 任务调度DBMS_SQL- 动态 SQL 执行DBMS_LOB- 大对象操作DBMS_CRYPTO- 加密功能DBMS_STATS- 统计信息收集命名约定Oracle 的DBMS_前缀包表示这些是数据库管理系统级别的内置包由 Oracle 提供用于扩展数据库的功能。textDBMS_ 数据库管理系统的 OUTPUT 输出 put_line 输出一行所以dbms_output.put_line()可以理解为数据库管理系统输出包中的输出一行过程。总结DBMS Database Management System数据库管理系统在 Oracle 中DBMS_是系统内置包的标准前缀这些包提供了数据库管理和操作的核心功能在 Oracle 中dbms_output.put_line()是一个用于输出信息的内置存储过程主要用于 PL/SQL 块的调试和信息显示。基本语法sqldbms_output.put_line(字符串表达式);使用步骤1. 启用输出重要在 SQL*Plus、SQL Developer 等客户端中需要先启用服务器输出才能看到结果sqlSET SERVEROUTPUT ON;2. 基本示例sqlSET SERVEROUTPUT ON; BEGIN dbms_output.put_line(Hello World); END; /输出textHello World3. 更多用法示例sqlSET SERVEROUTPUT ON; DECLARE v_name VARCHAR2(50) : 张三; v_age NUMBER : 25; BEGIN -- 输出变量值 dbms_output.put_line(姓名 || v_name); dbms_output.put_line(年龄 || v_age); -- 输出表达式结果 dbms_output.put_line(10 20 || (10 20)); -- 循环中输出 FOR i IN 1..5 LOOP dbms_output.put_line(第 || i || 次循环); END LOOP; END; /注意事项不显示 NULL输出 NULL 值时不会显示任何内容sqlBEGIN dbms_output.put_line(NULL); -- 不输出任何东西 END;缓冲区限制默认缓冲区大小为 20,000 字节可通过以下方式修改sqlSET SERVEROUTPUT ON SIZE 1000000; -- 设置为 1MB SET SERVEROUTPUT ON SIZE UNLIMITED; -- 无限制Oracle 10g主要用于调试不应用于生产环境的关键逻辑因为会消耗性能用户可能看不到输出客户端可能不支持调试示例sqlSET SERVEROUTPUT ON; CREATE OR REPLACE FUNCTION calculate_bonus(p_salary NUMBER) RETURN NUMBER IS v_bonus NUMBER; BEGIN dbms_output.put_line(输入薪水 || p_salary); IF p_salary 10000 THEN v_bonus : p_salary * 0.1; dbms_output.put_line(高薪员工奖金率10%); ELSE v_bonus : p_salary * 0.05; dbms_output.put_line(普通员工奖金率5%); END IF; dbms_output.put_line(计算奖金 || v_bonus); RETURN v_bonus; END; / -- 测试函数 BEGIN dbms_output.put_line(最终奖金 || calculate_bonus(12000)); END; /相关过程dbms_output.put()输出但不换行dbms_output.new_line()输出换行符dbms_output.get_line()从缓冲区获取一行dbms_output.get_lines()从缓冲区获取多行dbms_output.enable()启用输出dbms_output.disable()禁用输出替代方案对于更复杂的日志需求考虑使用UTL_FILE写入文件LOG4PLSQL日志框架DBMS_APPLICATION_INFO记录到 V$SESSIONdbms_output.put_line()是 PL/SQL 开发中最简单实用的调试工具之一。