“extension is not compatible”几乎必因版本不匹配：需用unzip -p xxx.vsix extension/package.json | grep engines核对插件要求的vscode版本（如^1.85.0）与本地code --version输出的主版本（如1.90.2→取1.90）是否兼容，且架构（darwin-arm64/x64等）一致。
VSCode离线安装插件总报“Extension is not compatible”怎么办
这几乎一定是版本不匹配，不是网络或权限问题。VSCode 启动时会严格比对 package.json 中的 "engines": {"vscode": "^1.85.0"} 和你本地 code --version 输出的第一段（如 1.90.2 → 取 1.90）。
实操建议：
- 解压
.vsix（它本质是 zip）：用unzip -p your.vsix extension/package.json | grep engines快速查看要求版本 - 在 VSCode 的 Help → About 里记下 Version（如
1.89.2）和括号里的架构（arm64或ia32），两者都必须一致 - ARM Mac 上装 x64 版本的插件（尤其含 native 二进制的，如
pyright、esbuild）也会触发该报错，需找带darwin-arm64标识的版本 - 别信第三方打包的
.vsix，必须从官方市场页面点击 Download Extension 获取
拖 vsix 进 VSCode 没反应？检查这三个状态
图形界面安装最简单，但失效有明确前提，不是操作本身错了。
常见卡点：
- VSCode 必须已加载工作区：空白启动页（没打开文件夹/文件）不响应拖拽；先 File → Open Folder 打开任意目录再试
- 拖放目标必须是编辑器主区域（白底代码区），不是侧边栏、设置页或扩展面板本身
- 右下角状态栏显示
Extensions disabled by policy→ 说明企业组策略禁用了扩展安装，GUI 和 CLI 都会失败，只能手动解压到extensions/目录 - 双击
.vsix文件通常无效：Windows 默认可能用浏览器打开，或静默失败；必须拖拽，不能双击
Vue 文件输入 vue 不生成模板？Vetur + 自定义代码片段要配全
仅装 Vetur 不足以触发 vue 前缀自动补全，必须配合用户代码片段，且文件后缀、语言模式要匹配。
关键步骤：
- 确保
.vue文件的语言模式是 Vue（右下角状态栏点击，选 Vue；不是 HTML 或 Plain Text） - 安装插件
octref.vetur（非Vue Language Features等替代品），安装后重启 VSCode - 新建代码片段：Preferences → User Snippets → New Global Snippets file… → 命名为
vue.json -
vue.json中必须包含"scope": "vue"或确保"prefix": "vue"对应的body是合法 Vue SFC 结构（含<template></template>、<script></script>、<style></style>）
Vue 组件跳转失效？jsconfig.json 路径映射不能少
当项目用 @/components/Hello.vue 这类别名导入时，VSCode 默认无法解析路径，导致 Go to Definition 失效或提示 Unable to load schema。
解决方法就是显式声明路径映射：
- 在项目根目录创建
jsconfig.json（不是tsconfig.json，即使你用 TypeScript，Vue CLI 默认也读jsconfig.json） - 内容至少包含
"compilerOptions": { "baseUrl": ".", "paths": { "@/*": ["src/*"] } } - 保存后重启 VSCode，或按
Ctrl+Shift+P输入 Developer: Reload Window - 验证：在
import Hello from '@/components/Hello.vue'上Ctrl+Click，应能跳转到对应文件
ms-python.python 安装后只是注册，首次打开 .py 文件才会去拉 pyright；而这个动作默认走外网，离线时只会卡在状态栏不动，或输出面板报 spawn ENOENT。这不是重装 .vsix 能解决的，必须提前在有网机器上完整触发一次下载，再把整个 extensions/ms-python.python-xxxx 文件夹拷过去。前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
