vue 3 项目中 volar 和 vetur 不能共存，因二者均接管 .vue 文件语言服务，底层机制冲突：volar 基于官方 @volar/vue-language-service 深度集成 vue-tsc，而 vetur 是 vue 2 旧架构，对 的 typescript 支持仅为模拟补丁，共存会导致类型推导失效、ref 跳转失败、defineprops 无提示等问题。
为什么 Vue 3 项目里 volar 和 vetur 不能共存
因为两者都接管 .vue 文件的语言服务，会互相覆盖语法解析逻辑，导致类型推导错乱、<script setup></script> 中的 ref 类型丢失、甚至智能提示完全失效。VS Code 启动时只会激活其中一个，但谁先加载、谁后注册没有保证，结果就是随机性报错。
实操建议：
- 打开扩展面板，搜索
vetur，点击「卸载」——不是禁用，必须彻底移除 - 确认已安装
Vue Official（即 volar 的官方维护版本，2026 年起已取代旧 volar 插件） - 重启 VS Code，打开任意
.vue文件，检查右下角状态栏是否显示「Vue (Volar)」而非「Vue (Vetur)」 - 若仍异常，删掉工作区根目录下的
.vscode/extensions.json（如有），避免残留配置干扰
path-intellisense 配置 @ 别名后依然不补全怎么办
常见原因是映射路径写错或未生效。VS Code 默认不认识 @ 是什么，必须显式告诉它指向 src 目录，且该配置只对当前工作区有效。
实操建议：
- 按
Ctrl+,打开设置，搜索settings.json，点击「在 settings.json 中编辑」 - 确认添加的是 workspace 级配置（不是用户级），内容为：
{ "path-intellisense.mappings": { "@": "${workspaceFolder}/src" } } - 注意：
${workspaceFolder}不是${workspacefolder}（大小写敏感） - 如果项目用了
src以外的源码目录（如app或frontend），需同步修改映射值 - 改完保存，重新打开一个
import语句，输入@/看是否弹出补全列表
用 react-syntax-plus 自动生成 useEffect 时变量名没匹配上
插件默认只匹配以关键字开头的已有变量名，比如你写了 const fetchData = () => {}，再输入 uefetch 才能触发；输 ueData 就找不到，因为它不模糊匹配，也不扫描函数体内部。
实操建议：
- 确保基础变量已声明在当前作用域顶层（不能在 if 块或嵌套函数里）
- 关键字必须紧贴变量名开头：想监听
userId，就输ueuserId，而不是ueUser - 变量名区分大小写，
UEuserId不会命中 - 如果变量是解构出来的（如
const { count } = props），插件无法识别，需改用直接声明方式 - 首次插入后按
Tab跳转到依赖数组位置，手动补全变量名——这是设计行为，不是 bug
cline 插件调用 deepseek API 总返回空字符串
根本原因通常是 API 密钥无效、请求超时，或 prompt 格式不符合模型预期。deepseek 的 code-generate 接口对输入长度和结构敏感，纯自然语言描述容易被截断或忽略。
实操建议：
- 在插件设置中检查
deepseek.apiKey是否粘贴完整（开头是sk-...，无空格、换行） - 测试时用极简 prompt，例如：
"写一个 Python 函数，接收 name 参数，返回 'Hello, ' + name—— 避免中文括号、emoji、多段描述 - 确认插件配置的
language字段与实际需求一致，比如生成 TypeScript 代码却设成python，会返回空 - 查看 VS Code 输出面板（
Ctrl+Shift+U→ 选Cline），看是否有401 Unauthorized或429 Too Many Requests日志 - 企业部署用户需确认本地 deepseek 服务是否正常响应，
curl -X POST http://localhost:8000/v1/code-generate测试连通性
