vscode中parcel跑不起来，根本原因是未在项目本地安装parcel（应npm install --save-dev parcel），且任务必须用npx parcel调用而非直接parcel；parcel无官方vscode插件，所谓插件多为过时壳。
VSCode 里装了 Parcel 插件却跑不起来，大概率不是插件问题，而是它根本没被调用——Parcel 本身没有官方 VSCode 插件，所谓“Parcel 插件”多是第三方封装或误认，真正起作用的是 parcel 命令行工具和你项目里的配置。
Parcel 没有官方 VSCode 插件，别被名字骗了
搜索 “Parcel” 安装的扩展（比如 parcel-bundler 或带 “parcel” 字样的）基本是过时、无维护、或仅提供语法高亮的壳。它们不参与打包流程，也不影响 parcel 命令执行。
- Parcel 自 v2 起就弃用全局安装方式，
npm install -g parcel-bundler已失效；当前正确安装方式是npm install --save-dev parcel（注意不是parcel-bundler） - VSCode 运行任务依赖终端能识别
parcel命令：在集成终端中执行npx parcel --version必须成功，否则所有“运行”操作都会静默失败 - 如果
npx parcel报错command not found，说明node_modules/.bin未被 PATH 包含，或项目根目录下没package.json和node_modules
tasks.json 中 command 写成 npx parcel 才可靠
VSCode 的运行任务（Ctrl+Shift+B）必须显式调用 npx，不能只写 parcel。因为 npx 会自动查找本地 node_modules/.bin/parcel，而直接写 parcel 会去系统 PATH 查找——这往往找不到，尤其在多项目、不同 Node 版本环境下。
- 在
.vscode/tasks.json中，"command": "npx"，"args": ["parcel", "serve", "${fileDirname}/index.html"]（入口文件按实际调整） - 别把
parcel serve合并进command字段，JSON 不支持带空格的命令字符串；参数必须拆进args - 加
"isBackground": true和"problemMatcher": ["$parcel"]，才能让 VSCode 正确捕获启动日志和端口信息
Live Server 和 Parcel serve 别混用
两者都是本地服务器，但定位完全不同：Live Server 是静态文件服务，不处理 import、JSX、SCSS 等转换；Parcel serve 是开发服务器，自带 bundler 和 HMR。同时启用会导致端口冲突、刷新逻辑错乱、甚至页面白屏。
- 如果项目用了
import或React组件，必须关掉 Live Server，只用parcel serve - 在 VSCode 右下角状态栏点击 Live Server 图标 → “Stop Server”，确保它没在后台占着
:5500 - Parcel 默认端口是
:1234，可改：在args中加"--port", "3000"，避免和 Rails/Express 冲突
package.json scripts 比 tasks.json 更稳
VSCode 的 tasks.json 容易因路径、shell 类型（PowerShell vs zsh）、工作区切换而失效；而 package.json 里的 scripts 是 npm 标准行为，跨平台一致，且 npx 自动匹配本地版本。
- 在
package.json中加："dev": "parcel serve src/index.html"（入口路径按需调整） - VSCode 中按 Ctrl+Shift+P → 输入 “Tasks: Run Script” → 选
dev，比手动配 tasks.json 少踩 80% 的坑 - 如果脚本启动后终端没输出、也没报错，检查
src/index.html是否真实存在——Parcel 不会提示“找不到入口”，只会静默退出
Parcel 的核心矛盾从来不在 VSCode 配置，而在“是否真正在项目本地装了它”。只要 npx parcel --version 能回显版本号，其他都是路径、端口、入口文件这些具体参数的事。别在插件市场里找“Parcel 支持”，盯住 node_modules/.bin/parcel 这个文件是否存在，比什么都管用。
