WebStorm 本身不内置 json-server 运行能力，需通过配置 NPM 运行脚本（如 "mock:server": "json-server --watch db.json --port 3000"）并创建对应运行配置来启动服务；须禁用 safe write、确保 UTF-8 编码、添加 Content-Type 请求头及符合 id 规则，才能保障增删改查与热更新正常。
WebStorm 本身不内置 json-server 运行能力，但可以无缝集成——关键不是“WebStorm 跑 json-server”，而是用 WebStorm 管理项目、编辑文件、执行脚本，最终靠 Node.js 启动 json-server。只要配置对，点一下「运行」就能起服务，不用切终端。
在 WebStorm 里直接运行 json-server 的正确姿势
WebStorm 不是终端，不能直接敲 json-server --watch db.json 就跑起来。必须把它包装成可识别的「运行配置」，否则右键菜单里根本不会出现「Run」选项。
- 打开 Run → Edit Configurations…，点击左上角 +，选 NPM
-
package.json路径要填绝对路径（WebStorm 有时自动填错，建议手动选） -
Command填run，Scripts填你定义的脚本名，比如mock:server - 确保
package.json里有对应 script："mock:server": "json-server --watch db.json --port 3000" - 勾选 Allow parallel run（避免改完数据后重启失败）
保存后，右键 package.json 或直接点工具栏绿色三角，就能启动服务 —— 日志会输出在 WebStorm 底部 Run 窗口，Ctrl+Click 可跳转链接。
db.json 改了没反应？检查 --watch 是否生效
很多人以为加了 --watch 就万事大吉，实际常见失效场景：
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- WebStorm 默认启用「safe write」：先写临时文件再替换原文件，
json-server监听到的是临时文件删除事件，而非内容变更 - 解决办法：进入 Settings → Appearance & Behavior → System Settings，取消勾选 Use "safe write"
- 确认
db.json编码是 UTF-8 无 BOM，否则json-server解析失败但不报错，只静默退出 - 如果用了
routes.json或中间件，务必在命令中显式指定路径，例如：json-server --watch db.json --routes routes.json --middlewares middleware.js
POST/PUT/DELETE 请求 404 或 405？别漏掉请求头和 ID 规则
前端发 POST 到 /users 却返回 405 Method Not Allowed，或新增数据后 id 字段为空 —— 这不是 WebStorm 的问题，而是 json-server 的默认约定没满足：
-
POST必须带Content-Type: application/json，否则被当成表单处理，直接 405 -
db.json中数组项必须含id字段（默认 key 名），且值为数字；若用_id，得加参数：--id _id -
PUT /users/1要求请求体里也带id: 1，否则json-server认为是创建新资源，会生成新 id - 想禁写操作（只读 mock）？加
--read-only参数，但此时POST/PUT/DELETE全部 405，不是 bug 是设计
跨域请求被拦截？WebStorm 不管这事，得靠 json-server 配置
浏览器报 CORS 错误，不是 WebStorm 没配好，而是 json-server 默认不开跨域 —— 它压根不处理请求头，只管路由和数据。
- 启动时加
--no-cors参数（注意是--no-cors，不是--cors）才能禁用 CORS 检查 - 更推荐方式：前端开发服务器（如 Vite、Webpack Dev Server）配代理，把
/api/代理到http://localhost:3000，比开--no-cors更安全 - 如果硬要用
--no-cors，记得只在开发环境用，上线前删掉，否则暴露接口风险
真正容易被忽略的，是 WebStorm 的文件监听机制和 json-server 的 watch 行为之间那层薄薄的耦合 —— 它不报错，只沉默，直到你发现改了 db.json 但接口没更新，才回头翻 safe write 设置。
