必须在项目根目录配置jsconfig.json,设"baseurl":"."和"paths":{"@/":["src/"],"~/":["src/"]},配置后重启vscode窗口方可生效。

别名路径跳转失效时怎么配 @/ 和 ~/
VSCode 默认不识别 @/ 或 ~/ 这类别名路径,按 Ctrl+单击 会提示 “无法打开定义”。这不是插件没装对,而是缺少项目级路径映射配置。
关键点在于:插件(如 Path Intellisense 或 vue-alias-skip)只负责“补全”和“跳转”,真正决定跳转目标的是项目根目录下的 jsconfig.json 或 tsconfig.json。
- 必须在项目根目录新建或编辑
jsconfig.json,内容至少包含"compilerOptions.baseUrl"和"compilerOptions.paths" -
"@/*": ["src/*"]是最常见映射,但若你用的是~/,就得写成"~/*": ["src/*"] - Vue CLI 项目默认支持
@/,但 Vite 项目需手动配置resolve.alias,且 VSCode 不会自动读取 vite.config.ts 中的 alias —— 必须同步写进jsconfig.json - 配置完后重启 VSCode 窗口(不是重载窗口),否则跳转仍不生效
ESLint 和 Prettier 一起用为什么报冲突
两者定位不同:ESLint 检查代码逻辑与规范(比如变量未定义、console.log 是否允许),Prettier 只管格式(换行、空格、引号)。它们规则重叠(比如缩进、分号)就会打架。
典型错误现象是保存后代码反复被格式化又报 ESLint 错误,或者 eslint --fix 把 Prettier 格式搞乱。
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
- 必须安装
eslint-config-prettier,并在.eslintrc.js的extends数组末尾加上它,用来禁用所有与 Prettier 冲突的 ESLint 规则 -
prettier插件本身不带修复能力,要靠ESLint的--fix或 VSCode 的 Format On Save 驱动,所以推荐把editor.defaultFormatter设为esbenp.prettier-vscode,再关掉eslint.formatEnable - 团队协作时,
.prettierrc和.eslintrc.js必须提交进 Git,不能只靠本地设置
Auto Rename Tag 在 Vue 的 <template></template> 里不工作
这个插件默认只处理纯 HTML 文件。Vue 单文件组件(.vue)中的 <template></template> 块属于自定义语言模式,插件需要显式启用支持。
不生效的直接原因是:VSCode 没把 <template></template> 内容识别为 HTML,所以插件监听不到标签变更。
- 打开设置(
Ctrl+,),搜索auto rename tag,勾选Auto Rename Tag: Enabled Languages,然后手动添加vue-html - 如果用的是 Vue 3 + Composition API,确保
vetur已卸载或禁用——它和官方Vue Language Features扩展冲突,会导致语言模式识别错乱 - 部分旧版插件不支持
<script setup></script>语法,建议升级到最新版Auto Rename Tag(v0.1.10+)
Quokka 实时运行结果突然卡住或不更新
Quokka 不是调试器,而是沙盒式实时执行环境。它依赖当前文件的上下文,一旦引用了外部模块、动态导入或副作用状态(比如全局 localStorage),就容易失准或停滞。
常见表现是右下角状态栏显示 “Running…” 却无输出,或变量值始终停留在第一次计算结果。
- 检查是否在代码中调用了异步函数(
fetch、setTimeout)但没加await或async—— Quokka 默认不等待 Promise 解析 - 避免在 Quokka 区域内修改全局对象(如
window、document),它没有 DOM 环境,这类操作会静默失败 - 大型数组或对象默认只展开 3 层,想看完整结构得右键选择 “Expand All”,否则可能误判为值没变
- 如果项目用了 Webpack 别名或动态
import(),Quokka 无法解析,建议临时改用相对路径测试
jsconfig.json 配置、eslint-config-prettier 加载顺序、Vue 语言模式识别,这三个地方最容易被忽略,但恰恰是多数“插件装了却不好使”的根源。前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










