PL/SQL Developer 13免安装中文版配置指南

简介PL/SQL Developer 13 可选中文语言免安装版是一套面向 Oracle 数据库管理员与开发人员的便携式开发工具包旨在免去传统安装步骤、消除英文界面带来的操作障碍。内置 SQL 与 PL/SQL 双编辑器支持语法高亮、自动补全、错误检查和断点调试能显著提升编码速度同时提供图形化对象管理、数据浏览编辑、性能报表生成、自动化脚本执行以及 SVN/Git 版本控制集成覆盖了日常开发、运维和团队协作的常见场景。压缩包整体约六十四兆字节解开即可运行不会改动主机系统既便于在不同电脑间转移也适合应急调试和快速部署。目前已有 1090 人学习下载对于希望低成本上手 Oracle 开发、追求高效便捷工作的数据库从业者来说是一份实用且省心的备选工具。1. 免安装的中文版不是黑匣子PLSQL Developer 13 为什么能「解压即用」看到「PLSQL Developer 13 可选中文语言免安装解压即用.7z」这个压缩包名很多人的第一反应是解压、双击、连库三步走完。实际用过的人会告诉你这个标题只讲了一半的真话——软件的绿色化确实省掉了安装向导那些下一步下一步但真正决定你能不能连上数据库的不是这个压缩包里的主程序而是它有没有替你准备好 Oracle 客户端环境。这个包的名字里藏着三层信息第一PL/SQL Developer 13 是当前 Oracle 开发工具里窗口化体验最顺手的一代13 相比老版本在代码补全和高亮上有明显提升第二可选中文语言意味着界面语言不是写死的解压后能在英文和中文之间切换第三免安装只是免掉了 MSI 安装流程不代表免掉 oci.dll 和 tnsnames.ora 的依赖。本文就把这条链路拆开讲清楚解压后放在哪个目录、OCI 库怎么指、tnsnames 怎么写、中文界面怎么切、连不上时从哪里查起。适合被 Oracle 客户端配置折磨过的人也适合第一次用 PL/SQL Developer 的新手照着落地。2. 绿色版背后的真实依赖不是解压就完事是替你省了安装步骤2.1 为什么 PL/SQL Developer 能做成免安装注册表与安装目录的关系PL/SQL Developer 本质上是个绿色友好的软件——它的主程序安装时往注册表里写的东西不多主要是一个安装路径和文件关联。安装版往注册表写的内容我这个包早就写成了配置文件所以解压就能启动主程序。但主程序能启动和你能连上数据库是两码事。常见的做法是解压后目录里除了 plsqldev.exe 主程序还带一个 Instant Client 子目录或者至少带一个说明文档告诉你去哪里下载。如果是前者那这个包的作者已经把 Oracle 官方那种压缩版客户端Instant Client一起压进去了你唯一要做的是在首选项里把 OCI 库指过去。如果只有主程序你需要自己准备一个 Oracle Client 或者 Instant Client这是最常见的翻车点。判断方法是看解压后的目录结构# 解压命令推荐用 7-Zip兼容性好 7z x PLSQL Developer 13 可选中文语言免安装解压即用.7z -oD:\Tools\PLSQLDev先解释这条命令7z x表示解压并保留目录结构-o指定输出目录注意-o后面紧跟路径没有空格。解压完打开目录看有没有类似instantclient_19_17这样的子目录有就省事没有就得自己补。我把这套东西固定放在D:\Tools\PLSQLDev不推荐放 C 盘特别是C:\Program Files这种带空格和 UAC 保护的路径后面写配置时路径带空格容易把 tnsnames 指向搞混权限问题也很阴间。2.2 oci.dll 是命门首选项里必须明确指定 Oracle 客户端位置PL/SQL Developer 连接 Oracle 数据库不是自己实现的协议它是通过 OCIOracle Call Interface调 Oracle 客户端库去连的。这个库在 Windows 上就叫oci.dll位置在 Instant Client 目录或完整 Oracle Client 目录下。主程序启动时不加载 oci.dll等你要连接时才加载所以你完全能打开界面、看到中文菜单却连不上库——这也是很多新手困惑的地方。配置方式很简单打开 PL/SQL Developer菜单栏找到 Tools工具下的 Preferences首选项。展开 Connection连接节点找到 OCI LibraryOCI 库配置项。把路径指到你解压出来的 Instant Client 目录下的 oci.dll比如D:\Tools\PLSQLDev\instantclient_19_17\oci.dll。保存并关闭重启主程序生效。这里有一个操作细节要注意有些绿色版的 Preferences 是跟随注册表走的有些是写在安装目录下的配置里的。如果你把目录从 D 盘挪到 E 盘第一次启动会报找不到库或者直接弹窗让你重新指定——这很正常重新指一遍即可不是什么玄学问题。参数上我建议这样选如果你的数据库是 19c 及以下版本用 19 系的 Instant Client 兼容性最好如果是 11g 老库Instant Client 12 或 11 更稳。不要盲目追新21c 的 Instant Client 连 11g 库有时能连上但字段类型映射有小毛病。2.3 没有 tnsnames 就没法按服务名连库最小配置实例Oracle 连接有两种主流方式一种是直接写连接串host:port/service一种是配 tnsnames.ora 用别名。生产环境里 DBA 给你的通常是一个服务名比如ORCL或PDB1这时候没有 tnsnames.ora 就很被动。Instant Client 模式下 tnsnames.ora 要放在客户端的network\admin子目录下注意不是随意放某个目录然后靠猜。# 文件位置D:\Tools\PLSQLDev\instantclient_19_17\network\admin\tnsnames.ora ORCL (DESCRIPTION (ADDRESS (PROTOCOL TCP)(HOST 192.168.1.10)(PORT 1521)) (CONNECT_DATA (SERVER DEDICATED) (SERVICE_NAME ORCL) ) ) PDB1 (DESCRIPTION (ADDRESS (PROTOCOL TCP)(HOST 192.168.1.20)(PORT 1521)) (CONNECT_DATA (SERVICE_NAME PDB1) ) )这段配置的含义第一行是别名就是你到时候在登录框里填的名字HOST是数据库服务器地址PORT默认 1521 不用改SERVICE_NAME是真正的服务名这个必须找 DBA 确认——很多人把SERVICE_NAME和SID混着填导致 ORA-12514。配完后还需要让程序能找到这个文件常见做法是设置环境变量# 设置 TNS_ADMIN 指向 network/admin 目录 setx TNS_ADMIN D:\Tools\PLSQLDev\instantclient_19_17\network\adminsetx是写永久环境变量写完要重开终端或重启主程序才生效。如果你不想动环境变量也可以每次在登录窗口直接填连接串但那样笔误的概率很高我反正不推荐。3. 中文语言与连接串落地的完整配置从解压到成功登录3.1 切换中文界面的三处控制点语言文件、注册表与启动参数标题里「可选中文语言」几个字的重点在「可选」——不是解压出来就是中文而是在某个配置点可以切换。PL/SQL Developer 的语言机制是外挂语言包主程序默认英文语言文件通常是 .lng 格式放在主程序目录下的Language子目录里中文的语言文件一般是Chinese.lng或SimpChinese.lng。我见过三种切换方式按成功率排序第一种是首选项里切。打开程序后进入 Tools Preferences User Interface Language下拉框里选 Chinese确定后重启程序。这是最正规的路径前提是你的包里确实带了语言文件。第二种是改注册表。老版本里语言设置存在HKEY_CURRENT_USER\Software\Allround Automations\PLSQL Developer里面有个Language字符串值改成Chinese再启动。第三种是启动参数。部分绿色版支持plsqldev.exe /language:Chinese这种参数但不通用我不太依赖这种方式。有一种情况要特别留意如果包内带的语言文件版本和主程序版本不一致切换中文后会有部分菜单项还是英文或者干脆切完界面全乱码。遇到这种情况优先找个和主程序版本完全匹配的语言文件替换掉旧的而不是反复切语言设置后者治标不治本。3.2 连接串的两种写法与登录窗口参数说明首次启动后登录窗口可能让你填 User、Password、Database。Database 那边你既可以直接填别名如 ORCL也可以填完整连接串。我建议首次落地时直接用完整连接串减少 tnsnames 没生效时排查问题的范围用户名scott 密码tiger 数据库192.168.1.10:1521/ORCL这个连接串的格式是IP:端口/服务名是 OCI 直连的写法不需要 tnsnames.ora 参与。先用它验证客户端到数据库的网络链路是否通通了之后再切回别名方式优化日常使用体验。如果直连串能连上但别名不行问题定位在 tnsnames.ora 路径或者 TNS_ADMIN 环境变量身上如果直连串都连不上那就是网络、监听或客户端位数的问题。登录框里还有一个角色Role选项Normal普通和 SYSDBA管理员。日常开发永远选 Normal。我看到很多新人手滑选成 SYSDBA连上去的确实是库但有些操作会被审计出了问题追查起来很不愉快。3.3 首次成功登录后的五个首选项目一次配好后面省心连上数据库只是开始真正让 PL/SQL Developer 好用的是这些首选项。我按重要性排个序每个都值得动一下配置项位置推荐值作用自动保存布局Tools Preferences User Interface开重启后窗口布局不跑编辑器字体Tools Preferences User Interface FontsConsolas 或微软雅黑中文注释不糊等宽字体对齐SQL 格式化Tools Preferences SQL Formatter按团队规范开SQL 语句可读性后面专门讲登录历史Tools Preferences Logon/Connection按需关闭保存密码是双刃剑日期显示Tools Preferences NLS与数据库会话一致避免日期显示成一堆数字这五项的共性是都藏在首选项的深层菜单里不花十分钟配好之后每次用时都会觉得别扭。特别是字体那项默认字体在中文 Windows 下渲染中文注释有锯齿感换成微软雅黑后人舒服很多。设置完这些你就拥有一个可以日常写查询、编译存储过程、看执行计划的中文绿色环境了。下一步要面对的是连接层面的几个常见错误它们占了 PL/SQL Developer 相关问题的八成。4. 连接报错的排查顺序ORA-12154、ORA-12514 与中文乱码4.1 ORA-12154TNS 无法解析指定的连接标识符这个错误是出现频率最高的报错弹窗里能看到的原文类似「ORA-12154: TNS:could not resolve the connect identifier specified」。它的含义是你填的别名在 tnsnames.ora 里找不到。原因一般是三类第一类tnsnames.ora 文件不存在。有人把 tnsnames.ora 放在了D:\Tools\PLSQLDev\根目录下甚至放在桌面。常见做法是把整个network\admin目录从 Instant Client 的安装目录里带过来而不是只复制文件。没有目录结构客户端找不到。第二类环境变量 TNS_ADMIN 指错位置。setx TNS_ADMIN之后再开一个终端看一眼能否读到可以用这个命令验证# 查看当前 TNS_ADMIN 值 echo %TNS_ADMIN%如果输出的是空或者路径和你实际放 tnsnames.ora 的位置不一致那必然解析不到。还要注意setx写的是用户环境变量有时候系统环境变量里残留一个旧值优先级和覆盖关系不够清晰。第三类文件名被 Windows 自动改成了tnsnames.ora.txt。这在用记事本新建文件保存时经常发生文件夹选项里「隐藏已知文件类型的扩展名」开着的话你根本看不到.txt尾缀。解决方法是强制重命名# 先确认实际文件名是什么 dir D:\Tools\PLSQLDev\instantclient_19_17\network\admin # 改名 ren tnsnames.ora.txt tnsnames.ora这类问题的排查顺序是先确认文件存在再确认路径被程序读取最后确认别名拼写大小写。Oracle 的别名解析在 Windows 上默认不区分大小写但建议还是保持一致。4.2 ORA-12514监听程序当前无法识别连接描述符中的服务这个报错典型场景是tnsnames 都配好了别名能解析但连的时候数据库说「我不认识这个服务名」。常见原因是把SERVICE_NAME写错。比如数据库是 CDB 模式DBA 让你连PDB1你写的却是ORCL那监听器不买账。另一个隐蔽原因是连接串里写了 SID 而不是 SERVICE_NAME# 错误写法SID 和 SERVICE_NAME 混用 192.168.1.10:1521:ORCLOCI 直连串的语法里冒号后面跟的是 SID 老式写法。现在 12c 以后的环境多用服务名正确写法是斜杠192.168.1.10:1521/ORCL当然有经验的 DBA 会把两者做了等价映射但你不能赌这个。识别方式是连上了要么错要么慢不如一开始就用标准格式。还有一类情况是监听没起来或者监听端口不对这个通常表现为 ORA-12541「无监听程序」而不是 12514。遇到 12541 时检查方向和数据库服务器上的服务状态有关客户端能做的事不多最快是让 DBA 确认lsnrctl status的输出。4.3 中文乱码的根源NLS_LANG 会话语言与数据库字符集好不容易连上库查询出来中文全变成问号或者一堆乱码这是 PL/SQL Developer 用户最想砸键盘的瞬间。这里先澄清一个误区这跟界面语言的中文汉化包没关系界面是界面数据是数据数据乱码是字符集转换问题。字符集转换的逻辑是Oracle 服务器存的数据按数据库字符集编码客户端会话按NLS_LANG环境变量指定的字符集解码。如果你的NLS_LANG是AMERICAN_AMERICA.US7ASCII那中文必然出问题。国内环境最常见的配置是SIMPLIFIED CHINESE_CHINA.ZHS16GBK对应的环境变量设置# GBK 字符集客户端 setx NLS_LANG SIMPLIFIED CHINESE_CHINA.ZHS16GBK如果数据库是 19c 及以上且字符集是AL32UTF8那建议用# UTF-8 字符集客户端 setx NLS_LANG AMERICAN_AMERICA.AL32UTF8一个项目里NLS_LANG 的最优值取决于数据库的字符集而不是取决于你个人偏好。确定数据库字符集的查询是SELECT value FROM nls_database_parameters WHERE parameter NLS_CHARACTERSET;拿到结果后对照表ZHS16GBK数据库配ZHS16GBK的 NLS_LANGAL32UTF8数据库配AL32UTF8的 NLS_LANG两边一致最不容易出问题。跨字符集不是不能连而是必须让 Oracle 做字符集转换转换规则按二进制处理有时候表面上能显示出来但已经是替换字符了。有一点要注意改完 NLS_LANG 必须重启 PL/SQL Developer因为它在启动时读取该环境变量来初始化会话运行中改环境变量是无效的。4.4 32 位与 64 位不匹配报错信息可能完全让你摸不着头脑这个坑最阴的地方在于你的 Windows 是 64 位的你的 PL/SQL Developer 也是 64 位的但 Instant Client 是 32 位的连库时报错内容五花八门轻则「ORA-12154」重则闪退。因为 oci.dll 的位数必须和主程序一致不是和操作系统一致。PL/SQL Developer 官方版本里 32 位版其实更常见原因是很多第三方插件当年只提供 32 位版本。所以你在安装或解压时先确认主程序位数# 看主程序是 32 位还是 64 位32 位会显示 x86 wmic process where nameplsqldev.exe get ExecutablePath然后在 Windows 任务管理器里看进程的位数信息。确认后再去检查 Instant Client 目录下的 oci.dll 是 32 位还是 64 位。一个快速验证技巧把 oci.dll 拖到一个 64 位记事本工具里如果提示无法加载它就是 32 位的——当然这个方法不够严谨最准确的方式是用工具看 PE 头。我常用的命令# 用 dumpbin 工具查看 dumpbin /headers oci.dll | findstr machine输出里有x64就是 64 位x86就是 32 位。匹配原则一句话主程序和 oci.dll 位数必须一致跟操作系统位数无关。市面上很多绿色压缩包作者默认发 32 位主程序配 32 位客户端就是为兼容性考虑这时候你装个 64 位 Instant Client 反而出错。5. 避坑记录这个绿色版最常见的 5 个翻车现场5.1 解压路径带空格导致 OCI 加载失败现象解压到C:\Program Files\PLSQL Developer后启动正常但连接时报找不到 oci.dll或者主程序直接闪退。原因路径里有空格。OCI 的加载逻辑在某些版本里对带空格的路径处理不友好再加上 UAC 权限导致主程序无法写入配置缓存。解决统一放到无空格的纯英文路径如D:\Tools\PLSQLDev。如果是已经装在 Program Files 里的别硬修复直接剪切整个目录到 D 盘再配置一次。5.2 杀毒软件把 Instant Client 目录当病毒隔离现象解压后还能用过两天启动 PL/SQL Developer 提示缺 oci.dll打开 Instant Client 目录发现里面少了几个文件或者整个目录不见了。原因orca 或某些安全软件对 dll 加载行为敏感把 Instant Client 里的部分 dll 判定为风险文件移入隔离区。这属于误报但确实会发生。解决把整个D:\Tools\PLSQLDev目录加入杀毒软件信任区。如果文件已经被删不要试图恢复直接从 Oracle 官方渠道重新解压一份 Instant Client 放进去更快。血的教训是尽量不要把绿色版压缩包和释放后的目录同时保留在一个磁盘上并被扫描否则每次解压都被拦。5.3 登录历史里存了旧密码导致连接串被覆盖现象你在登录窗口填了新库的地址但每次点连接都连到旧库或者明明填了正确的数据库却直接报错。原因PL/SQL Developer 的登录窗口有个下拉历史它默认选中了历史的某个连接配置你输入的 Database 被历史记录自动补全覆盖了。这个行为在 13 版本里尤其不明显因为下拉框默认展开的是最近一次的配置。解决登录窗口的 Database 字段右边有个下拉箭头点开手动选择「空」再输入或者每次连接前把该字段全选删除后重新输入。另一个根治方法是首选项里关闭保存登录历史Tools Preferences Logon/Connection 取消勾选 Allow saving of history。5.4 中文界面切换后部分菜单还是英文现象按前述方法切换到中文主菜单大部分变成中文了但某些子菜单或右键菜单还是英文或者弹窗里的按钮文字仍是英文。原因语言文件不完整或版本不匹配。绿色版的作者打包时用的语言文件可能是从旧版本拿过来的13 新增的功能项没有对应的中文翻译条目。解决先确认语言文件名称。PL/SQL Developer 13 的 Chinese 语言文件在某些版本里叫Chinese.lng有些包里还带一个ChineseS.lng。两者区别不绝对我见过的是繁体与简体的差异。优先替换成和主程序同版本发布的语言文件替换后重启如果还不行把语言切回英文确认功能正常再切中文。这个顺序很重要能排除「语言文件本身损坏」和「主程序功能异常」两种情况。5.5 数据库字符集是 UTF8我配了 GBK为什么偶尔乱码偶尔正常现象查询某张表的某些行正常另外一些行中文显示成问号数字和英文完全没问题。原因ZHS16GBK 无法表示所有 Unicode 字符。数据库是 AL32UTF8某一行的内容里含有 GBK 字符集编码不了的字符比如生僻字或特殊符号转换时就变成了替换字符。表面上「偶尔乱码」其实不是随机是特定字符必然乱码。解决以数据库字符集为准设置 NLS_LANG。已经配错的改完重启连上去查询还是有问题验证一下会话字符集SELECT sys_context(USERENV, LANGUAGE) FROM dual;输出会告诉你当前会话的 NLS_LANG 实际上是什么如果和你的环境变量配置一致那就是字符本身超出了映射范围不再属于配置问题而是数据本身的情况。6. 进阶技巧SQL 格式化与存储过程调试的日常顺手操作在 PL/SQL Developer 13 里有一个功能很多人用了几年都没碰过内置的 SQL Formatter。它的入口在菜单栏的 Edit SQL Formatter Format 或者默认快捷键 CtrlF12能帮你把杂乱无章的 SQL 重排成年限分级缩进的格式。但我不是让你全盘接受默认规则13 版本支持自定义格式化规则Tools Preferences SQL Formatter 里有大小写转换、关键字对齐、逗号换行方式等选项。团队协作时把这些规则导成文件传阅代码风格能统一到一个相对好看的状态避免每次 code review 都在争论缩进。调试存储过程是这个工具的老本行。在对象浏览器里找到你要调试的 Procedure右键选择 Test程序会生成一个测试窗口自动补齐了BEGIN ... END;的骨架代码。你要做的只是填入参数值然后 F9 开始调试。这里有个关键配置调试时如果需要看变量值和断点必须把 DEBUG CONNECT 权限给到当前用户GRANT DEBUG CONNECT TO 用户名; GRANT DEBUG ANY PROCEDURE TO 用户名;不给权限时点 F9 会直接报错或者根本没反应新手容易误以为程序卡死了。调试过程中可以按 CtrlN 加断点在 Watch 窗口里观察变量也可以用 Step IntoF7逐行走。最后一招是窗口布局记忆功能。把常用窗口摆成一个固定的布局——左边对象树中间 SQL 窗口下方输出面板——然后在 Tools Preferences User Interface Layout 里保存为默认。重装或者换机器时把布局配置文件拷过来你的工作台就瞬间回到顺手状态。我第一次换电脑时忘了做这件事新机器上的窗口到处乱跑花了三天才调回顺眼的样子。从那以后每次用完都会顺手保存一次布局。这个习惯希望你也能养成希望帮到你。本文还有配套的精品资源点击获取