运行npm run dev时出现“Invalid command: dev”错误的原因排查

DevOps 小满

2026-6-13

问题分析：Svelte项目执行npm run dev报错"Invalid command: dev"

问题重现

执行命令：npm run dev
报错信息：

ERROR
Invalid command: dev
Run $ svelte-kit --help for more info.

项目配置说明

项目package.json已定义dev脚本，且svelte-kit已作为开发依赖安装，配置内容如下：

{
  "name": "xyz",
  "version": "1.0.0",
  "type": "module",
  "scripts": {
    "dev": "vite dev",
    "build": "vite build",
    "preview": "vite preview",
    "test": "vitest",
    "test:e2e": "playwright test"
  },
  "devDependencies": {
    "@playwright/test": "^1.51.1",
    "@sveltejs/adapter-auto": "^6.0.0",
    "@sveltejs/kit": "^2.20.7",
    "@sveltejs/vite-plugin-svelte": "^5.0.3",
    "autoprefixer": "^10.4.21",
    "postcss": "^8.5.3",
    "prettier": "^3.5.3",
    "svelte": "^5.27.0",
    "svelte-preprocess": "^6.0.3",
    "tailwindcss": "^4.1.4",
    "typescript": "^5.8.3",
    "uuid": "^11.1.0",
    "vite": "6.2.6",
    "vitest": "^3.1.1"
  }
}

排查结论

开发依赖无异常：从配置看，@sveltejs/kit、vite、svelte的版本匹配，都是当前稳定版，没有明显版本冲突问题。
错误核心原因：报错指向svelte-kit的dev命令无效，说明实际执行的不是你定义的vite dev脚本——SvelteKit v2+已弃用svelte-kit dev命令，统一改用vite dev。
解决建议：
- 确认终端当前处于项目根目录（package.json所在文件夹），避免npm找不到脚本定义。
- 检查是否误执行了svelte-kit dev而非npm run dev，或者终端环境有别名/全局命令干扰了npm run dev的执行。
- 尝试清除依赖后重装：
```
rm -rf node_modules package-lock.json
npm install
```
- 重新执行npm run dev，确保命令拼写正确。