Live Server不能用于React/Vue项目,因其仅为静态服务器,不处理import、JSX、.vue组件或打包逻辑,直接打开index.html会导致模块加载失败、HTML被误解析等错误;正确做法是使用对应框架的开发服务器(如npm start或vite dev)。

Live Server 为什么不能直接用于 React/Vue 项目
它只起一个静态服务器,不处理 import、jsx、.vue 单文件组件或模块打包逻辑。直接右键“Open with Live Server”打开 index.html,浏览器会报 Failed to load module script 或 Cannot find module 错误。
常见错误现象:
-
Uncaught SyntaxError: Unexpected token '<'(实际是返回了 HTML,但浏览器当 JS 解析) Failed to resolve module specifier "react"- Vue 模板里
<template>标签未被解析,原样显示在页面上
正确做法:
- React 项目用
npm start(Create React App)或vite dev启动开发服务器 - Vue 项目同理,依赖
vue-cli-service serve或vite dev - 若硬要用 Live Server 配合构建产物,需先
npm run build,再用 Live Server 打开dist/index.html
Debugger for Chrome 配置失败的三个高频原因
不是插件装了就能断点,launch.json 配置错一处,整个调试链就断在第一步。
立即学习“前端免费学习笔记(深入)”;
最容易踩的坑:
-
"url"写成"http://localhost:3000",但实际服务跑在:5173(Vite 默认端口)或:8080(Vue CLI)——必须和你启动的 dev server 端口一致 -
"webRoot"指向错误路径,比如写成"${workspaceFolder}/src",但实际入口 HTML 在public/index.html,导致断点无法命中源码 - 没开启 source map:Webpack 要配
devtool: 'source-map',Vite 默认已开,但若手动关了build.sourcemap就会失效
验证是否生效:在 JS 文件里打个断点,F5 启动调试,Chrome 自动弹出且页面加载后断点变红 —— 这才算通了。
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
Prettier 和 ESLint 一起用时格式冲突怎么解
二者规则重叠(比如引号、分号、空行),不协调就会出现「保存一下,ESLint 报错;自动修复一下,Prettier 又改回去」的死循环。
关键解决点:
- 必须安装
eslint-config-prettier,并在.eslintrc.js的extends数组末尾加上它,禁用所有与格式相关的 ESLint 规则 - VS Code 设置中指定 Prettier 为默认 formatter:
"editor.defaultFormatter": "esbenp.prettier-vscode" - 避免在
.prettierrc里设"semi": true,同时又在 ESLint 里开"semi": ["error", "always"]—— 这类重复定义是冲突根源
一个简单验证法:删掉 eslint-config-prettier,执行 npx eslint --fix,看控制台是否输出 “conflict” 类提示。
Volar 和 Vetur 到底该装哪个
Vue 3 项目装 Vetur 会直接失效 —— 它已停止维护,不支持 <script setup></script>、组合式 API 类型推导、defineProps 自动补全等核心能力。
实操判断标准:
- 项目是 Vue 3 + TypeScript?→ 必装
Volar,并确保关闭 Vetur(VS Code 会提示冲突) - 项目是 Vue 2?→ 只能用
Vetur,Volar 不兼容 - 遇到
Cannot find name 'defineProps'报错?大概率是 Volar 没启用,或工作区设置了错误的语言模式(右下角应显示 “Vue (Volar)” 而非 “Vue”)
注意:Volar 需要配合 vue-tsc 做类型检查,仅靠插件本身无法捕获 props 类型不匹配这类问题。

















