TypeORM在WebStorm中需显式调用AppDataSource.initialize()才能使用，否则报ConnectionNotFoundError；entities路径、tsconfig配置及NODE_ENV环境变量必须正确设置，Database工具窗口需手动重载Schema。
WebStorm里跑TypeORM，先确认DataSource是否已初始化
没调用AppDataSource.initialize()就直接查数据，会报ConnectionNotFoundError或QueryRunnerProviderNotFound。TypeORM的DataSource不是声明即连接，必须显式初始化。
- 确保在应用启动时（比如
main.ts或index.ts）调用了await AppDataSource.initialize() - 如果用了
synchronize: true，初始化过程会自动建表——仅限开发环境，生产环境务必关掉 - 初始化失败时，
AppDataSource.isInitialized为false，后续所有manager或getRepository调用都会抛错 - WebStorm不会主动提示“你忘了初始化”，错误堆栈里通常只显示
Cannot get entity manager这类模糊信息
在WebStorm中调试Repository操作时，别依赖“自动补全”推断实体类型
WebStorm对TypeORM的getRepository(User)返回类型识别依赖于@Entity()装饰器和正确的entities路径配置。路径写错、文件未被TS编译器包含、或tsconfig.json里include漏了entity/**/*.ts，都会导致userRepository.find()返回any，补全失效，且无明显报错。
- 检查
data-source.ts中entities字段：路径需匹配实际文件结构，例如['src/entity/**/*.ts']不能写成['entity/**/*.{ts,js}'] - 确认
tsconfig.json的include包含实体目录，否则TS语言服务无法索引类定义 - WebStorm状态栏右下角的
TypeScript小部件若显示“Not available”，说明TS服务未加载，补全和类型检查全部失效 - 临时验证方式：在
getRepository(User)后加as UserRepository，看是否能触发方法补全；不能则问题出在类型识别链路上
执行SQL迁移时，WebStorm的Terminal和Database工具窗口要配合着用
TypeORM的typeorm migration:run命令只改数据库结构，不刷新WebStorm的Database工具窗口视图。你可能在终端看到Ran migrations:，但Database窗口里表还是旧的，甚至新建的列不显示。
- 运行完迁移后，在Database工具窗口右键对应数据源 → Reload Database Schema（快捷键
Ctrl+F5） - 如果迁移脚本里用了
queryRunner.query("ALTER TABLE ...")这种原生SQL，WebStorm无法自动推断变更，必须手动重载 - Migration文件名带时间戳（如
1678886400000-add-user-email.ts），但WebStorm的Database窗口不按时间排序，建议在Database工具窗口顶部启用Speed Search Filter快速定位新表 - 别在Database窗口里手动删表再跑迁移——TypeORM默认不覆盖已有表，冲突时直接报错退出
DataSource多环境切换时，WebStorm的Run Configuration容易忽略NODE_ENV
TypeORM常靠process.env.NODE_ENV决定加载哪套配置（dev/staging/prod），但WebStorm默认Run Configuration不传这个环境变量，结果永远连的是localhost:5432，压根没读.env.production。
- 打开Run → Edit Configurations → 选中你的Node.js配置 → Environment variables里手动加
NODE_ENV=production - 如果用
dotenv加载.env，确保require('dotenv').config()在DataSource创建前执行，否则WebStorm启动时读不到变量 - WebStorm的Database工具窗口连接的是独立数据源，和代码里的
DataSource无关——它不会自动随NODE_ENV切换，得手动配多个数据源并命名区分 - 一个容易被忽略的点：
DataSource构造函数里用process.env.DB_HOST拼接配置时，WebStorm的Debugger断点能看到变量值，但Terminal里npm run start可能因Shell环境不同而读不到，务必统一用Run Configuration管理
