VSCode中数据库模块require失败主因是环境路径错乱或配置冲突。需确认npm install在package.json目录执行、检查TS模块类型、清除.vscode缓存、修正launch.json的program和cwd、用__dirname定位SQLite路径、关闭SQL插件避免文件锁、处理MySQL 8.0认证插件兼容性。
VSCode 里 node -v 能跑，但数据库模块（如 mysql2、sqlite3）死活 require 不进去，十有八九不是代码写错了，而是环境链断在了某个你没注意的环节——模块安装路径、进程工作目录、TS 模块解析规则、甚至 VSCode 自己的语言服务缓存。
npm install mysql2 报错或 require 失败
这不是 VSCode 的锅，是模块根本没装到 Node.js 进程能看见的地方。
- 先确认终端当前路径就是
package.json所在目录，再执行npm install mysql2；在错误目录下装，模块会进父级node_modules或全局，require()就找不到 - 用 monorepo 或
npm link？运行npm ls mysql2，如果输出带extraneous标记，说明路径错乱，得重装或改用npm install ../path/to/mysql2 - TypeScript 项目里用
import加载mysql2却报错？检查tsconfig.json是否含"type": "module"，否则 ESM/CJS 解析冲突直接崩 - 装完还是报
Cannot find module？删掉项目根目录下的.vscode文件夹，重启 VSCode——语言服务缓存可能卡住了旧的node_modules结构
launch.json 中 program 路径指向错误
调试时断点不生效、conn.connect() 根本不执行，大概率是 launch.json 里的 program 指向了错误文件。
- 纯 JavaScript 项目：设
"program": "${workspaceFolder}/db.js"，确保该文件存在且导出连接逻辑 - TypeScript 项目：
program必须指向编译后的.js（如"${workspaceFolder}/dist/db.js"），同时tsconfig.json含"sourceMap": true，且.js.map和.js在同一目录 - 加
"cwd": "${workspaceFolder}"，避免require('./config')因工作目录错位而报Cannot find module - 别用
${file}调试多文件项目——它只跑当前打开的文件，不会加载依赖链
SQLite 数据库路径和锁冲突
new sqlite3.Database('./data.db') 看似简单，但 ./ 是相对于 process.cwd()，不是 VSCode 工作区，也不是你当前打开的文件位置。
- 错误做法：把
db.js放在src/下，然后在终端cd src/再跑node db.js→ 此时./data.db会落在src/data.db，而非你预期的项目根目录 - 推荐写法：
const db = new sqlite3.Database(path.join(__dirname, '../data.db'))，用__dirname锁定脚本位置，再向上找 - 调试时加一行
console.log('DB path:', path.resolve(__dirname, '../data.db'))，直接看到真实路径 - VSCode 插件（如 SQLTools）打开同名
.db文件时，会持有读锁甚至写锁，Node.js 进程可能静默失败，或更糟——在 Windows 上创建一个空的新库。调试前关掉所有 SQLite 插件
MySQL 认证插件不兼容（ER_NOT_SUPPORTED_AUTH_MODE）
这是 MySQL 8.0+ 默认改用 caching_sha2_password 插件导致的，和代码、VSCode 都无关，Node.js 的 mysql 或旧版 mysql2 不支持它。
- 本地开发可临时降级：进 MySQL 命令行，执行
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password';，再FLUSH PRIVILEGES; - 如果用 Docker，启动时加参数
--default-authentication-plugin=mysql_native_password - 连接配置里保持
user: 'root'、password: 'your_password'不变，其他字段无需动 - 升级
mysql2到 v3.x+ 可原生支持，但要注意 Promise API 有 breaking change
最常被忽略的是：VSCode 终端的 process.cwd() 和你直觉认为的“当前项目”未必一致；还有 SQLite 文件锁这种看不见摸不着的冲突，往往查半天以为是代码问题，其实只是插件在后台偷偷占着库。动手前，先 console.log 出路径、npm ls 查模块位置、关掉所有可能抢锁的工具——比瞎调代码快得多。
