VSCode 中 Node 找不到是因未正确配置 PATH，需检查终端与 VSCode 启动环境差异；模块未找到需确认项目根目录及执行 npm install；调试超时应显式设置 launch.json 的 cwd；查询无结果需添加错误处理并检查异步写法与字段大小写。
VSCode 里 node 找不到，根本跑不起来数据库连接代码
不是 VSCode 本身的问题，而是你没告诉它用哪个 node。VSCode 默认不自带 Node 运行时，它只是调用系统 PATH 里的 node。如果终端里能跑 node --version，但 VSCode 的终端或调试器报 Command 'node' not found，大概率是终端 shell 和 VSCode 启动环境 PATH 不一致。
实操建议：
- 在 VSCode 终端里执行
which node（macOS/Linux）或where node（Windows），确认路径； - 检查 VSCode 是否以非登录 shell 启动（比如通过桌面图标直接打开），导致 shell 配置文件（
~/.zshrc、~/.bash_profile）未加载； - Mac 用户常见坑：VSCode 从 Spotlight 或 Finder 启动时，不会读取
~/.zshrc，需改用终端命令code启动； - Windows 用户注意：确认是否安装了多个 Node 版本（如 nvm-windows 和官方 installer 并存），优先用
nvm use切换并验证node -v；
require('mysql2') 报错 Cannot find module 'mysql2'
这是典型的模块未安装或作用域错误。VSCode 不负责安装依赖，它只运行你写的代码——而 node 在当前工作目录下找 node_modules。
实操建议：
- 确保你在项目根目录（含
package.json）下打开 VSCode，而不是某个子文件夹； - 在 VSCode 内置终端中执行
npm install mysql2（或pnpm add mysql2），不要跳过这步； - 如果用了 TypeScript，还需装类型定义：
npm install --save-dev @types/mysql2； - 检查
node_modules/mysql2是否真实存在，有时杀毒软件或权限问题会阻止安装完成；
调试时连接数据库超时，但用 node script.js 能连上
VSCode 调试器（launch.json）默认工作目录可能和你预期不一致，尤其当你有多个 package.json 或符号链接时。
实操建议：
- 在
.vscode/launch.json中显式指定"cwd"字段，例如："cwd": "${workspaceFolder}"； - 确认数据库连接配置（host/port/user/password）是否硬编码在代码里，而你实际运行时靠环境变量（如
.env）注入——调试模式下dotenv可能没加载； - 加一行
console.log(process.cwd(), process.env.DB_HOST)，对比终端直跑和调试器输出； - PostgreSQL 用户注意：
pg默认启用 SSL，而本地开发常关 SSL，需显式设ssl: false；
connection.query() 返回空结果，但 SQL 在 CLI 里能查到数据
这不是 VSCode 配置问题，而是 Node 异步行为 + 错误处理缺失的典型表现。VSCode 只是执行环境，它不会吞掉你的错误。
实操建议：
- 永远给
connection.query()加catch或.on('error', ...)，否则连接失败或 SQL 错误会被静默丢弃； - MySQL 用户注意：
mysql2的query方法返回 Promise 仅当使用promise()包装器（如mysql2/promise），否则仍是回调风格； - 检查字段名大小写：MySQL 在 Linux 下表名/列名区分大小写，Node 侧 JS 对象属性访问是严格匹配的；
- 用
console.dir(rows, { depth: null })查看完整返回结构，避免误判“空”——有时是空数组[]，有时是undefined；
真正卡住的地方，往往不是 VSCode 设置，而是你没让错误浮出来。把 console.error 和 try/catch 当成必写项，比折腾配置有用得多。
