Oracle Developer Tools for VS Code是Oracle官方唯一维护的VS Code扩展，原生支持OCI、tnsnames.ora、Wallet及Kerberos；安装需匹配.NET Core 2.2.x/3.1 LTS，连接须严格配置Host（如127.0.0.1）、Port（如1521）和SERVICE_NAME（非SID），并设置oracle.nlsLang为AMERICAN_AMERICA.AL32UTF8防中文乱码。
Oracle Developer Tools for VS Code 是唯一官方支持的扩展
VSCode 连接 Oracle 数据库，只有 Oracle Developer Tools for VS Code 是 Oracle 官方维护的扩展，其他如 SQLTools、Database Client 均不原生支持 Oracle 协议（无 OCI 集成、不解析 tnsnames.ora、不处理 Wallet 或 Kerberos）。装错扩展会导致连接失败且错误信息模糊，比如报 ORA-12154: TNS could not resolve the connect identifier 却找不到配置入口。
安装步骤必须严格按顺序：
- 先确认已安装
.NET Core 2.2.x或3.1 LTS（不是 .NET 5/6/7+，新版会启动失败） - 在 VSCode 扩展市场搜索
Oracle Developer Tools for VS Code，认准发布者是Oracle - 安装后必须重启 VSCode，否则侧边栏不会出现 Oracle 图标
- 不依赖本地 Oracle Client（如 instantclient），但若要用
tnsnames.ora方式连接，该文件路径需手动填入设置项oracle.tnsAdmin
Basic 连接方式下 host/port/service name 必须匹配监听配置
选 Basic 连接类型时，三个字段缺一不可，且大小写敏感、空格不可省略：
-
Host：不能填localhost（可能走 IPv6 回环失败），推荐用127.0.0.1；远程库则填真实 IP 或 DNS 名 -
Port：默认是1521，不是8080或22；若 Oracle 使用非标准端口（如1522），这里必须同步修改 -
Service Name：不是 SID，也不是数据库名；必须和lsnrctl status输出里的SERVICE_NAME一致，常见错误是填了ORCL却实际服务名为orclpdb1
填完点 Create Connection 后，右下角出现绿色提示 Connected to [name] 才算成功；若弹出 Connection failed，不要反复重试，先检查 Oracle 监听器是否运行（lsnrctl status）及防火墙是否放行端口。
执行 SELECT * FROM USER_TABLES 查不到表？先确认当前 schema
Oracle 的对象权限和 schema 绑定极紧。即使连接成功，执行 SELECT * FROM USER_TABLES; 返回空结果，大概率是因为当前用户没建表，或你误连到了 SYSTEM / DBA 用户而非业务 schema。
验证方式：
- 运行
SELECT SYS_CONTEXT('USERENV', 'CURRENT_SCHEMA') FROM DUAL;确认当前 schema 名 - 查自己拥有的表：用
USER_TABLES（仅当前用户） - 查所有可见表：用
ALL_TABLES（需有SELECT ANY TABLE权限） - 查全部表（DBA 角色）：用
DBA_TABLES（普通开发账号通常无权访问）
右键表名“Query Table”功能只对 USER_* 和 ALL_* 视图生效；若表不在当前 schema 下，需显式写 schema_name.table_name，例如 HR.EMPLOYEES。
中文字段名或数据乱码？问题出在 NLS_LANG 而非 VSCode 编码
VSCode 自身设成 UTF-8 没用——Oracle 连接层默认使用服务器 NLS 设置握手，若客户端未声明字符集，就会丢字。典型表现是字段名显示为 ????，或查询结果中中文变成问号。
解决方法只有两个有效路径：
- 在 VSCode 设置中添加
oracle.nlsLang，值设为AMERICAN_AMERICA.AL32UTF8（推荐，全局生效） - 或在连接配置里加自定义参数：
"nlsLang": "AMERICAN_AMERICA.AL32UTF8"（仅对该连接生效）
注意：AL32UTF8 是 Oracle 对应 UTF-8 的内部编码名，别写成 UTF-8 或 utf8；Windows 用户若仍乱码，可尝试 AMERICAN_AMERICA.ZHS16GBK（仅限 GBK 环境）。
真正容易被忽略的是：一旦连上，这个 NLS 设置就固化在会话里，改 VSCode 文件编码或系统区域设置都无效。断开重连才能生效。
