Oracle Developer Tools for VS Code是唯一支持Oracle原生协议的官方扩展，需正确安装、配置tnsAdmin路径、严格匹配Host/Port/Service Name参数，且依赖.NET Core 2.2/3.1运行时，并确保监听器运行及防火墙放行端口。
不是插件没装对，就是连接参数填错了——90% 的失败都卡在这两步。
Oracle Developer Tools for VS Code 是唯一能用的官方扩展
其他名字带 “SQL”“Database” 的插件（比如 SQLTools、Database Client）根本不支持 Oracle 原生协议：tnsnames.ora 解析、Wallet 加载、Kerberos 认证全都不行。装错后报 ORA-12154: TNS could not resolve the connect identifier，但设置里根本找不到 tnsAdmin 或 oracle.nlsLang 这类关键项，纯属白忙。
- 必须在 VS Code 扩展市场搜
Oracle Developer Tools for VS Code，发布者是Oracle（不是个人或第三方） - 安装后必须重启 VS Code，否则左侧边栏不出现 Oracle 图标
- 它不依赖本地
instantclient或ORACLE_HOME，但若要用tnsnames.ora，得手动填oracle.tnsAdmin路径（比如C:\oracle\network\admin）
Basic 连接方式下三个字段必须严格匹配监听配置
填错一个就连不上，而且错误提示非常模糊，容易反复试错。
-
Host：别填localhost—— Windows 下可能走 IPv6 回环失败；本地库填127.0.0.1，远程库填真实 IP 或 DNS 名 -
Port：默认是1521，不是8080或22；如果监听器启在1522，这里必须同步改 -
Service Name：必须和lsnrctl status输出里的SERVICE_NAME完全一致，大小写敏感、空格不可省略；常见错误是填了ORCL，实际服务名是orclpdb1
.NET Core 版本不兼容会导致插件启动失败
插件后台依赖 .NET Core 运行时，但只认 .NET Core 2.2.x 或 3.1 LTS。装了 .NET 5/6/7+ 会静默失败：图标不显示、右键无菜单、命令面板搜不到 Oracle:Connect。
- 检查是否已安装兼容版本：
dotnet --list-runtimes，确认输出含Microsoft.NETCore.App 2.2.或3.1. - 不要卸载新版 .NET，只需额外装一个
.NET Core 3.1.32 SDK（官网可下载离线包） - 装完重启 VS Code，再点侧边栏 Oracle 图标 —— 如果仍空白，打开 VS Code 开发者工具（
Ctrl+Shift+I），看 Console 是否有Failed to activate extension oracle.oracledevtools报错
中文乱码和连接成功但查不出表结构
连上不代表能用，oracle.nlsLang 配置缺失会导致中文字段名/注释显示为问号或方块，DESCRIBE 查表结构时字段类型也错乱。
- 在 VS Code 设置中搜索
oracle.nlsLang，设为AMERICAN_AMERICA.AL32UTF8 - 这个值不能简写成
AL32UTF8或US7ASCII，否则 NLS 参数不生效 - 改完不用重启，新建 SQL 文件执行
SELECT * FROM NLS_DATABASE_PARAMETERS;可验证当前会话字符集
最易被忽略的是监听器状态和防火墙——哪怕所有参数都对，lsnrctl status 显示监听未运行，或服务器防火墙没放行 1521 端口，VS Code 就只会卡在“Connecting…”或弹出模糊的超时提示。动手前先在服务器上跑一遍 telnet 127.0.0.1 1521，比在 VS Code 里点十次 Create Connection 更有效。
