npm init -y 能跑通但生成的 package.json 往往不适用开发：缺 "type": "module" 导致 import 报错，scripts 仅含 test 需补 start 和 dev，name 含大写或下划线会导致 publish 失败，vscode 终端路径错或未继承 path 也会引发命令失败。
npm init -y 能跑通，但生成的 package.json 往往不能直接用于开发——缺 type、缺 scripts、name 字段还可能非法。
npm init -y 没反应？先看终端在哪
VSCode 内置终端默认打开位置不固定，尤其多窗口或从桌面图标启动时，很可能不在你想要的文件夹里。这不是命令坏了，是路径错了。
- 按
Ctrl + `唤出终端，立刻执行pwd（macOS/Linux）或cd（Windows），确认当前路径 - 如果不对，用
cd /your/project/path切过去，再输npm init -y - 别依赖右键菜单里的“在集成终端中打开”——VSCode 1.118 及之前版本对多根工作区的支持仍有路径继承问题
生成的 package.json 缺 "type": "module" 怎么补
Node.js ≥ 14.13 默认用 CommonJS，但你写 import 就会报 ERR_REQUIRE_ESM。这个字段不是可选的，是模块解析规则的开关。
Json Schema Toolkit
下载
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
- 手动编辑
package.json，在顶层加一行："type": "module" - 或者初始化时一步到位：
npm init -y && npm pkg set type=module - 注意：加了之后所有
.js文件都走 ES Module 规则，require()会失效；不加则import报错。二者不可混用
scripts 字段空有 "test"？至少补上 start 和 dev
npm init -y 只生成最简 scripts，但日常开发离不开运行和热重载。
- 补
"start": "node index.js"—— 这是npm start的基础入口 - 补
"dev": "node --watch index.js"—— Node.js 20.6+ 原生支持--watch，不用装nodemon -
name字段若含大写字母或下划线（如"My_API"），后续npm publish会失败，建议同步改成小写短横线格式（"my-api"）
VSCode 里敲 npm init 提示 command not found: npm
这跟 npm init 本身无关，是 VSCode 没继承系统 PATH。哪怕你在系统终端能跑，VSCode 里照样报错。
- 在系统终端运行
which npm（macOS/Linux）或where npm（Windows），记下路径（比如/opt/homebrew/bin/npm） - 检查 shell 配置文件（
~/.zshrc或~/.bash_profile）是否导出该路径，例如：export PATH="/opt/homebrew/bin:$PATH" - 改完后重启 VSCode，或干脆从系统终端执行
code .启动它——这样环境变量一定带进来
真正卡住人的从来不是命令记不住，而是 package.json 里少一个字段、终端差一个路径、VSCode 漏一条环境变量——这些细节不显眼，但每个都足以让 node index.js 直接失败。
