根本原因是Node.js模块解析路径未覆盖TypeORM依赖链，常见于DataSource手动初始化或ts-node未正确加载node_modules；需确认typeorm真实存在、TS配置moduleResolution和esModuleInterop、ts-node加-r参数、pnpm store修复、launch.json设cwd及显式加载dotenv。
VSCode里TypeORM报“Cannot find module”或启动失败
根本原因不是TypeORM没装，而是Node.js模块解析路径没覆盖到TypeORM依赖链——尤其当项目用DataSource手动初始化、或ts-node运行时未正确加载node_modules。常见现象是import { DataSource } from 'typeorm'报错，或npm run dev直接退出。
- 确认
node_modules/typeorm真实存在：在终端执行ls node_modules/typeorm（Linux/macOS）或dir node_modules ypeorm（Windows），空目录说明安装不完整，重跑npm install typeorm @types/node - TS项目必须配
tsconfig.json的"moduleResolution": "node"和"esModuleInterop": true，否则TS编译器无法识别CommonJS导出 - 用
ts-node运行时，别只写ts-node src/index.ts，要加-r ts-node/register参数确保装饰器和ESM兼容性，例如：ts-node -r ts-node/register --files src/index.ts - 如果用了
pnpm，检查pnpm store是否损坏，执行pnpm store status，异常时运行pnpm store prune再重装
launch.json调试时TypeORM连接不上数据库
报错如ConnectionError: Failed to connect to localhost:3306或DriverNotInstalledError，不是数据库没开，而是VSCode调试器进程没读到环境变量或驱动缺失。
-
.env文件不会被Node原生加载，必须用dotenv显式注入：在入口文件顶部加require('dotenv').config()，且launch.json中"envFile"字段仅对调试器生效，不影响运行时代码 - MySQL驱动
mysql2、PostgreSQL驱动pg等必须单独安装，TypeORM不自带；验证方式：npm ls mysql2（非typeorm子依赖） -
launch.json里务必设"cwd": "${workspaceFolder}"，否则process.cwd()指向VSCode安装目录，.env和配置文件路径全错 - Windows上若用Named Pipe连接SQL Server，路径含反斜杠易被JSON解析为转义字符，改用正斜杠：
"host": "localhost\SQLEXPRESS"→"host": "localhost/SQLEXPRESS"
TypeORM日志不输出SQL或参数为空
配置了logging: true却只看到query没内容，或INSERT INTO user VALUES (?)但看不到实际值，本质是日志级别和logger实现没对齐。
- 别只写
logging: true，必须指定数组：logging: ["query", "error", "schema"]，否则默认只记录错误，"query"项才触发SQL打印 - 要显示绑定参数（如
VALUES ('alice', 25)），需同时开启logQueries: true和logger: new AdvancedConsoleLogger("all")，后者来自typeorm包内，不能漏引 - 日志默认输出到
console，VSCode终端滚动快易丢失，改用文件输出：logger: new FileLogger("query.log")，再用tail -f query.log监控 - 如果用
DataSource构造，日志配置必须放在new DataSource({ ... })参数里，而不是forRoot()的插件选项中
VSCode里断点进不去Repository方法
在this.userRepo.find()行打的断点永远不命中，不是调试配置错，而是TypeORM的Repository是运行时动态代理生成的，源码不在你的项目里。
- VSCode无法为代理方法生成source map，所以断点无效；能打断点的位置只有：调用
find()的那行（停在Promise创建处）、你自己写的Service层逻辑（如if (user.age ）、或<code>QueryRunner手动事务块 - 想查SQL执行细节，别靠断点，用
QueryRunner显式控制：const qr = dataSource.createQueryRunner(); await qr.manager.query('SELECT * FROM user');，这样每条SQL都可单步跟踪 - TS项目确保
tsconfig.json有"sourceMap": true和"inlineSources": true，否则即使打了有效断点，也可能因map错位跳到空白行 - 如果用了
@nestjs/typeorm，注意InjectRepository注入的是代理实例，断点仍无效；真正可调试的是Repository类里的自定义方法（如findActiveUsers()），前提是它写在你自己的.ts文件里
真正卡住人的，往往不是“TypeORM怎么配”，而是以为logging: true就等于看到SQL、以为断点打在find()就能停住、或者把.env当成Node自动加载的魔法文件——每个环节都得用具体命令验证，比如node -e "console.log(require('typeorm').DataSource)"看模块能否加载，npm ls pg查驱动是否存在，cat .env | grep DB_HOST确认变量拼写。
