strapi调试必须绕过cli，用launch.json配置runtimeexecutable指向本地npm并传参["run","develop"]，启用node_options="--enable-source-maps"，v4/v5分别指向对应develop.js路径，v5还需先执行npm run build。
直接运行 npm run develop 最稳，调试必须绕过 CLI、指向 develop.js 入口，并启用 NODE_OPTIONS="--enable-source-maps"，否则断点永远不命中。
launch.json 配置必须用 request: "launch" + runtimeExecutable 指向 npm
Strapi v4/v5 的 strapi develop 命令是 CLI 封装，VSCode 直接运行 node 会跳过环境变量和插件加载逻辑。正确做法是让 VSCode 启动本地 npm：
-
runtimeExecutable设为"${workspaceFolder}/node_modules/.bin/npm"（Linux/macOS）或"${workspaceFolder}/node_modules/.bin/npm.cmd"（Windows） -
args必须是["run", "develop"]，不是["develop"]—— 后者绕过package.json中的 scripts，导致process.env缺失 - 务必在
env中加入"NODE_OPTIONS": "--enable-source-maps"，否则 TypeScript/ESM 源码断点位置错乱 - Strapi v5 还需确保已执行过
npm run build，否则develop.js启动时找不到dist/会直接退出
断点进不了 src/api/xxx/controllers/xxx.js？检查 program 是否误配
很多教程抄错入口路径，导致 VSCode 根本没加载你的代码。Strapi 不是从 src/index.js 启动的：
VSCode 1.118
下载
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话 。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本 。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
- v4 正确路径：
"${workspaceFolder}/node_modules/strapi/lib/commands/develop.js" - v5 正确路径：
"${workspaceFolder}/node_modules/@strapi/strapi/dist/commands/develop.js" - 绝对不要设
program为src/index.js或bin/strapi.js—— 这两个文件在 v4+ 中已不承担主启动职责 - 如果用了 Docker 开发，必须通过
Remote - Containers连入容器，并确认容器内已安装node和npm，只挂载源码无效
REST Client 测试 API 时反复 400/401，不是接口问题，是请求体格式不对
Strapi v4/v5 的 REST API 强制要求顶层包裹 data 字段，且 header 与 body 之间必须有空行：
- 错误写法：
{"title":"test"}→ 触发 400 - 正确写法：
{"data":{"title":"test"}}，且Content-Type: application/json和 JSON 体之间要有一行空行 - JWT Token 必须从
POST http://localhost:1337/api/auth/local响应中手动提取response.body.data.jwt，不能复用 Admin UI 的 session cookie - Strapi v5 默认禁用 local 认证，需在
config/admin.ts中显式开启auth: { enabled: true }才能拿到 token
最常被忽略的是：Strapi v5 要求先 npm run build 再调试，否则 develop.js 读不到生成的类型定义，进程直接退出——这个错误没有明确提示，只会卡在命令行不动。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
