WebStorm启动慢卡在“正在索引”，主因是node_modules被全量索引，需右键标记为Excluded，并调大VM内存（如16GB机器设-Xmx4096m）、启用Node.js插件、排除dist等无关目录。
WebStorm 启动慢，Fastify 项目卡在“正在索引”？先关 node_modules
90% 的 WebStorm + Fastify 组合卡顿，根源不是 Fastify 本身，而是 IDE 默认把 node_modules 当作源码全量索引。Fastify 依赖链深、类型声明多（尤其 @fastify/ 系列插件），node_modules 里几万个文件一扫，CPU 占满、内存爆表、补全延迟——根本不是代码问题。
必须右键 node_modules → Mark Directory as → Excluded。同理处理：dist、build、.next（若混用 Next.js）、coverage。注意：Excluded 图标要出现在整个目录树上，不是只在顶层；用了 pnpm 或 Yarn PnP 的，还要去 Settings → Languages & Frameworks → JavaScript → Libraries 检查是否误加了 node_modules 到库路径。
vmoptions 内存配小了，Fastify 路由热重载直接失败
Fastify 的路由注册、Schema 编译、插件加载都依赖 TypeScript 类型推导和符号解析。WebStorm 默认的 -Xms256m -Xmx512m 连 fastify.register() 嵌套三层插件都会触发频繁 GC，表现为：保存文件后热重载无反应、app.get() 断点不命中、schema 校验提示消失。
- 8GB 内存机器 → 改为
-Xms1024m -Xmx2048m - 16GB 内存机器 → 改为
-Xms2048m -Xmx4096m - 务必追加一行：
-XX:ReservedCodeCacheSize=1024m（否则 TS/JS 语言服务降级，request.body类型提示失效）
改完后必须完全退出 WebStorm（不是关窗口），再重启——参数才生效。
Fastify 插件调试时断点跳过，检查是否禁用了 Node.js 插件
WebStorm 默认不启用 Node.js 运行环境支持。如果你在 fastify.register(require('./plugin')) 里打的断点永远不触发，大概率是 Node.js 插件被禁用了。这不是 Fastify 的锅，是 IDE 没认出这是可调试的 Node 进程。
进 Settings → Plugins，搜索 Node.js，确保它处于启用状态。同时确认：Run → Edit Configurations → Templates → Node.js 中，Working directory 指向项目根目录，Javascript file 是你的 app.js 或 server.ts，且 Node interpreter 选的是你项目本地的 node（不是全局）。
Fastify 日志被吞掉，Pino 输出在 WebStorm 控制台乱码或不显示
Fastify 默认用 Pino 打日志，而 WebStorm 的终端对 ANSI 颜色码和流式输出兼容性差。常见现象：启动后控制台空白、logger.info() 不打印、甚至 fastify.listen() 成功回调也不触发。
两个实操动作：
- 在 Fastify 实例创建时显式关闭颜色：
const fastify = require('fastify')({ logger: { transport: { target: 'pino-pretty', options: { colorize: false } } } }) - WebStorm 运行配置中勾选：
Add content roots to classpath和Add generated sources to classpath（尤其 TypeScript 项目）
如果仍无日志，临时改用 console.log 替代 fastify.log.info 排查——这能快速区分是 Pino 配置问题，还是 WebStorm 运行环境没接住 stdout。
node_modules 没 exclude、vmoptions 没调够、Node.js 插件没开——这三件事不做，再好的 Fastify 性能也跑不起来。 
