webstorm创建typescript项目会自动生成tsconfig.json，但仅含基础选项（如"target":"es2015"），需手动添加"strict":true等配置以启用类型检查、路径别名等功能，否则将导致类型提示失效、import报红等问题。
创建 TypeScript 项目时，tsconfig.json 自动生成但常被忽略
WebStorm 创建 TypeScript 项目时会自动生成 tsconfig.json，但它默认只启用基础编译选项（如 "target": "es2015"），不包含类型检查、严格模式或路径别名支持。如果你后续遇到类型提示失效、import 路径报红、或 noImplicitAny 未生效，大概率是这个文件没被正确配置。
- 新建项目后立刻打开
tsconfig.json，手动添加"strict": true和"baseUrl": "./"（如需路径映射） - 若项目用 Vite 模板生成（勾选了“生成带有入门提示的 Playground 项目”），注意它可能用的是
vite.config.ts中的resolve.alias，而非tsconfig.json的paths—— 两者需保持一致，否则 WebStorm 的跳转和自动补全会断掉 - 不要依赖 WebStorm 的“自动修复”弹窗来初始化 tsconfig；它只生成骨架，不推导项目实际需求
node_modules 没加载？检查 package.json 是否被识别为项目根
WebStorm 不靠文件夹名判断项目结构，而是靠是否存在 package.json 且含 "type": "module" 或 "scripts" 字段。如果打开一个含 package.json 的子目录，但 WebStorm 把父级当项目根，node_modules 就不会被索引，导致 import 提示失败、ESLint 不工作、甚至 npm run 命令不可用。
- 右键点击含
package.json的文件夹 → 选择Reload project，强制 WebStorm 重新扫描依赖 - 确认项目根目录下确实有
package.json；若没有，WebStorm 默认按纯静态项目处理，不会启动 Node.js 集成 - 如果用了 pnpm/yarn workspaces，确保
package.json中有"workspaces"字段，否则 WebStorm 只识别顶层node_modules
远程服务器部署前，必须先配好 Deployment 的 Mappings tab
很多人在 Settings | Build, Execution, Deployment | Deployment 里填完 FTP/SFTP 主机信息就以为完事了，结果上传后页面 404——根本原因是没设置 Mappings。WebStorm 不会自动把项目根映射到服务器文档根，它需要你明确告诉它：“本地的 dist/ 对应服务器上的 /var/www/html/”。
- 切换到
Mappingstab 后，Local path必须指向你实际要部署的输出目录（比如dist/，不是项目根） -
Deployment path on server必须写相对路径（如/或/myapp），不是绝对路径；WebStorm 会把它拼到你在Connectiontab 里填的服务器根路径之后 - 如果用本地服务器（如 XAMPP/MAMP），
Deployment path on server建议留空或填/，避免多层嵌套导致 URL 错位
多个项目同时开发？别用“Open Folder”，要用“Open Project”
WebStorm 不支持单窗口多项目。如果你直接通过系统文件管理器双击打开某个子项目文件夹，IDE 会把它当作独立项目加载，但 .idea 配置可能继承自父项目或冲突，导致调试配置、运行脚本、甚至 Git 分支显示异常。
- 每次新开项目，都从欢迎界面点
Open，而不是在已打开项目里用File | Open - 若必须并行开发，启动多个 WebStorm 实例；每个实例只开一个项目，且确保各自
.idea目录互不干扰 - 团队共享时，
.idea/deployment.xml和.idea/runConfigurations/是关键配置，务必提交进 Git —— 但排除.idea/workspace.xml（含个人 UI 状态）
package.json 和 tsconfig.json 的存在位置，不看你心里觉得哪儿该是根。改错一个路径，整个类型推导和部署映射就全偏了。
