Vue2Click
Vue 2 优先,兼容 Vue 3 常用 <script setup> 编辑场景。不依赖 Vetur 或 Vue - Official,装完直接可用,无运行时依赖。
F12 跳转 · Ctrl+Space 补全 · Ctrl/Cmd + . 代码操作 · 输入 vbase 生成组件骨架
三个差异点
- 数字索引直接翻译成业务文案:
serviceOperateBtn[1] 悬停显示 1 → "我要催单",动态索引显示完整映射,不用再翻公共常量文件。
- 改名不会悄悄改坏:重命名组件成员会同步当前 SFC 模板;改 props 会同步父组件的
:user-name,保留 kebab-case 写法。
- 轻量:项目语义服务按需启动,普通
.js / .css 文件不会挂上全仓库监听。
功能
| 能力 |
说明 |
| 跳转与补全 |
模板、脚本、样式之间的定义跳转;成员、组件、props、自动导入补全;props / 事件 / 插槽契约提示 |
| 类型与语义 |
类型悬停、/** */ 注释、参数提示、查找引用、语义重命名 |
| 检查 |
模板中未声明的成员、缺失的相对资源、脚本诊断、CSS/SCSS/Less 校验,支持单文件手动检查 |
| 样式 |
模板 class 定位到样式规则;@import / url() 跳转;HTML/CSS/SCSS/Less 路径补全与格式化 |
| Vue 3 轻量兼容 |
defineEmits 事件提示、withDefaults 默认值、defineModel 属性与事件、v-model 定义跳转 |
| 编辑 |
Vue 文件格式化、标签自动闭合、Vue 2 / Vue 3 代码片段 |
| 复制代码 |
选中代码后右键 →「复制代码和行数」→「完全路径 / 相对路径」,复制起止行列与选中代码,方便粘贴到 Codex |
两个选项均使用 路径:起始行:起始列-结束行:结束列 选中的代码,保留选中内容的缩进与换行。相对路径以文件所属工作区目录为基准;文件不在工作区时使用完全路径。适用于已保存到磁盘的各类代码文件,读取当前编辑内容,无需先保存修改。
行列从 1 开始,结束位置不包含在选区内,与编辑器的选区边界一致;列按 UTF-16 字符位置计算,Tab 计一个字符。例如 src/views/AfterSale.vue:197:5-200:17 表示从第 197 行第 5 列,到第 200 行第 17 列之前。
空 Vue 文件中输入 vue3 / vbase3 生成 JavaScript <script setup> 骨架,输入 vue3ts / vbase3ts 生成 TypeScript 版本。script setup 中会过滤 Options API 片段;事件补全支持 @update:modelValue 和 v-on:update:modelValue,保留已有修饰符并过滤已经绑定的事件。
配置
默认配置即可使用,只在需要时写进项目的 .vscode/settings.json。
| 配置项 |
默认 |
作用 |
vueClick.definition.enabled |
true |
定义跳转 |
vueClick.completion.enabled |
true |
补全与自动导入 |
vueClick.languageService.enabled |
true |
项目语义分析(类型、引用、重命名) |
vueClick.formatting.enabled |
true |
Vue 文件格式化 |
vueClick.diagnostics.enabled |
false |
活动文件自动诊断 |
vueClick.diagnostics.staticChecks |
true |
诊断中的模板成员与缺失资源检查 |
常改的两处:
{
// 开启自动诊断;大项目可保持关闭,改用「检查当前文件」
"vueClick.diagnostics.enabled": true,
// 让 VueClick 接管 Vue 文件格式化
"[vue]": {
"editor.defaultFormatter": "jokeran.vueClick",
"editor.formatOnSave": true
}
}
- 用 Prettier 时把
vueClick.formatting.enabled 设为 false,不冲突。
- 路径别名写在
jsconfig.json / tsconfig.json 的 compilerOptions.paths,插件不执行 vue.config.js。
- 想用
Tab 展开 Emmet:"emmet.includeLanguages": { "vue": "html" }。
命令
- VueClick: 检查当前文件 — 单次检查,不开启自动诊断
- VueClick: 重启语言服务 — 补全或类型信息异常时重置
- VueClick: 查看项目与服务状态 — 查看项目目录、诊断开关、线程状态
边界
- Vue 2(Options API)优先;Vue 3 兼容范围以常用
script setup 静态声明为主。项目类型分析需要安装项目对应的 Vue 依赖,复杂宏类型仍有边界。
- 静态分析只报能确定的问题:遇到
mixins、extends、setup、展开运算符、动态成员时直接跳过,不猜。
- 重命名 props 时父组件同步有上限(最多 200 个
.vue),超出部分不自动改名,宁漏不误。
本版改进与验证 · 完整说明与边界 · 组件契约 · 更新日志 · 第三方声明
| |