PhpStorm内置终端运行npm run dev会卡在“Compiling…”是因为其终端模拟层截断TTY信号，导致HMR失效、服务未真正启动；应改用系统终端执行，PhpStorm仅用于编辑与调试。
PhpStorm 本身不托管 Vue 开发服务器，强行让它启动 npm run dev 会导致热更新失效、端口占用、控制台无输出——这不是配置没到位，是根本用错了执行路径。
为什么在 PhpStorm 内置终端运行 npm run dev 会卡在 “Compiling…”
PhpStorm 的内置终端默认启用“Shell integration”和“Emulate terminal in output console”，但 Vue CLI 或 Vite 启动的服务依赖完整的 TTY 环境与信号转发（比如 SIGUSR2 触发热更新）。PhpStorm 终端模拟层会截断或忽略这些底层交互，导致进程挂起、HMR 不触发、浏览器空白页。
常见现象包括：
- 控制台只打印
Compiling...后再无日志，实际服务并未真正监听 - 修改
.vue文件后浏览器无刷新，Network 面板看不到hot-update.json请求 - 手动访问
http://localhost:3000显示连接被拒绝，lsof -i :3000查不到进程
正确做法：关闭所有 PhpStorm 的 Run Configuration，用系统终端（macOS Terminal / Windows PowerShell / Linux GNOME Terminal）执行 npm run dev 或 pnpm dev。PhpStorm 只负责编辑、跳转、断点调试 —— 它不是运行容器。
立即学习“PHP免费学习笔记（深入）”；
ref、defineProps 标红且无法跳转的真正原因
标红不是插件没装，而是 PhpStorm 没把当前文件识别为 Vue 3 + TypeScript 上下文。它需要同时满足三个条件才能激活响应式类型推导：
- 项目根目录存在
package.json，且dependencies或devDependencies中包含"vue": "^3.4.0"或更高版本 -
node_modules已完整安装（vue和@vue/runtime-core必须存在） -
tsconfig.json的compilerOptions.types包含"vue"，例如："types": ["webpack-env", "jest", "vue"]
如果用了 <script setup lang="ts"></script>，还需确认 Settings → Languages & Frameworks → JavaScript → Libraries 中已勾选 Vue.js 库（不是“Download”，是已识别本地 node_modules/vue）。
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
<template></template> 里写 v-if 没提示、@click 标黄怎么办
这是语言注入缺失，不是 Vue 插件故障。PhpStorm 默认把整个 .vue 当作纯文本处理，<template></template> 块不会自动当 HTML、<script></script> 块也不会自动当 TS/JS。
必须手动注入：
- 右键点击
<template></template>标签 → Inject language or reference → 选HTML - 右键点击
<script></script>标签（或<script setup></script>）→ Inject language or reference → 选TypeScript（若用 TS）或JavaScript - 更彻底的方案：进
Settings → Editor → Language Injections，新增规则：对script[type="text/typescript"]和template标签自动注入对应语言
注意：如果 <style></style> 用了 lang="scss" 却跳不到变量，同样要检查是否为该块注入了 Sass 语言（需提前安装 Sass 插件）。
@/components 路径无法 Ctrl+Click 跳转
别名路径解析失败，90% 是因为 tsconfig.json 里没配 baseUrl 和 paths，或者配了但没重启 PhpStorm。
示例配置（tsconfig.json）：
{
"compilerOptions": {
"baseUrl": ".",
"paths": {
"@/*": ["src/*"],
"@components/*": ["src/components/*"]
}
}
}
关键动作：
- 保存
tsconfig.json后，必须执行File → Invalidate Caches and Restart → Just Restart - 确保项目根目录已标记为
Resources Root（右键目录 → Mark Directory as → Resources Root），否则@/会被当字面量处理 - 如果用的是 Vite，还要确认
vite.config.ts中resolve.alias与tsconfig.json一致，否则运行时正常、IDE 里跳转仍失效
最易忽略的一点：改完 tsconfig.json 不重启 IDE，所有路径提示都会继续失效——PhpStorm 的类型服务不会热重载配置。
