Node.js 调试时日期异常的根本原因是时区未统一配置，需在 launch.json 中通过 "env": { "TZ": "Asia/Shanghai" } 提前注入，并确保 GraphQL resolver、数据库驱动、客户端变量及时区偏移均显式处理。
Node.js 调试配置必须启用 --inspect 且时区参数要提前注入
带有时区和日期转换逻辑的 GraphQL 服务（比如用 Date.prototype.toLocaleString()、Intl.DateTimeFormat 或依赖 moment-timezone）在调试时容易因 Node 进程默认时区（UTC）与预期不符，导致断点处时间值“看起来不对”。这不是代码 bug，而是环境缺失。
VSCode 的 launch.json 默认不传递时区，得手动加 env：
-
"env": { "TZ": "Asia/Shanghai" }—— Windows/macOS/Linux 都认这个变量，比process.env.TZ = '...'更早生效 - 不要写
TZ=Asia/Shanghai node --inspect...：VSCode 启动器不解析 shell 前缀，会直接报错 - 如果服务启动命令是
npm run dev，建议改用node --inspect --env.TZ=Asia/Shanghai ./src/index.js并在launch.json中用runtimeArgs拆解
GraphQL 查询中日期字段返回异常？先确认 schema 是否暴露了时区上下文
VSCode 插件（如 GraphQL for VSCode）只校验语法和字段存在性，不执行运行时逻辑。当你在 .graphql 文件里写 query { events { startsAt } } 却得到 UTC 时间，问题大概率不在编辑器，而在 resolver 层没做时区适配。
常见陷阱：
- Resolver 返回
new Date()或date.toISOString()—— 这些始终是 UTC，前端再转本地也晚了 - PostgreSQL/MySQL 的
timestamptz字段被 ORM（如 Prisma）自动转成 JSDate对象，但时区信息丢失，需显式调用date.toLocaleString('zh-CN', { timeZone: 'Asia/Shanghai' }) - GraphQL SDL 中字段类型仍是
String或DateTime（非标准 scalar），插件无法推断其语义，补全和校验无意义
调试时查看真实日期值，别只信 console.log
console.log(new Date()) 在 VSCode 调试控制台显示的是本地时区格式（受系统影响），但 Node 进程内部仍按 UTC 存储。这会造成“看到的和用的不一致”的错觉。
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
更可靠的验证方式：
- 在断点处用调试器右键变量 → “Copy value”，粘贴出来看是否含
Z（UTC）或+08:00（CST） - 打印
date.getTimezoneOffset()：返回-480表示东八区，0表示 UTC - 用
date.toLocaleString('en-US', { timeZone: 'Asia/Shanghai' })强制格式化，避免依赖环境默认行为
GraphQL 请求插件发查询时，时区相关变量传参容易被忽略
你在 .graphql 文件里写：
# GraphQL Request: http://localhost:4000/graphql
query GetEvents($from: DateTime!, $to: DateTime!) {
events(from: $from, to: $to) { id startsAt }
}然后在 VSCode 右键 → “GraphQL: Run Query with Variables”，弹窗填 { "from": "2026-07-01T00:00:00" } —— 这个字符串没有时区标识，GraphQL server 默认当 UTC 解析。
正确做法：
- 变量值必须带时区偏移，如
"2026-07-01T00:00:00+08:00"或"2026-07-01T00:00:00Z" - 如果前端传的是用户本地时间，后端 resolver 必须先用
new Date(input + '+08:00')显式绑定时区，再存库或比较 - 别依赖插件自动补全变量格式：它不会提醒你缺时区，只会静默发送
时区不是“配一次就完事”的设置，它横跨 Node 进程启动、数据库驱动、GraphQL scalar 解析、客户端变量输入四个环节，任一环掉链子，调试时看到的时间就不可信。
