vscode无内置每次保存生成.bak文件的备份功能,必须依赖local history插件或外部机制;该插件在项目根目录建.history/文件夹,每次保存前自动存带时间戳副本,仅监控已打开文件,右键可查看恢复。

VSCode 没有内置“每次保存生成 .bak 文件”式的自动备份功能,所谓“自动备份”必须靠插件或外部机制实现;Vue 开发环境搭建的关键不是装得多,而是 Volar 接管是否生效、ESLint 和 Prettier 是否协同、路径别名是否对齐——装错或配漏一个点,智能提示就直接失效。
Local History 插件:最轻量的每次保存前快照
它不依赖 Git,也不上传云端,在项目根目录下自动生成 .history/ 文件夹,每次保存前存一个带时间戳的副本。适合防手抖误删、快速回退局部修改。
- 安装后默认启用,无需改设置;想调保留天数,搜
local-history.maxFileHistory改数值(单位是天) - 只监控「当前已打开」的文件,没在编辑器里打开的
.js或.vue不会记录 - 右键文件 →
Local History: Show History可对比/恢复;但注意:.history文件夹不能被.gitignore误删,否则快照永久丢失 - 不兼容符号链接(symlink)目标文件——如果项目里用软链指向 src,.history 不会跟踪链后的真实路径
Volar Take Over Mode:Vue 智能提示生效的前提
装了 Volar 却没有跳转、ref 类型显示为 any、defineProps 不推导,90% 是因为没开启接管模式。Vetur 必须禁用,两者共存会导致语言服务直接罢工。
递归分析 Vue 项目组件依赖,从入口文件生成组件层级图,支持 Vue 2/3,输出组件名、文件路径和属性。适用于分析组件结构、排查依赖或了解项目架构。
- 按
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS),输入Volar: Switch to Take Over Mode并执行 - 检查设置中
volar.enableTakeOverMode是否为true;同时确认Vue: Enabled和TypeScript: Enabled都已勾选 - 若用了 Vue 3.3+ 的
defineProps宏或ref()解构,必须开启Vue > Experimental: Vue Macros,且重启整个 VSCode 窗口(不是重载) - 路径别名(如
@/components)跳转失败?不是插件问题,是tsconfig.json里compilerOptions.baseUrl和paths没配,或和vite.config.ts中的resolve.alias不一致
ESLint + Prettier 协同配置:避免保存时反复打架
两个插件都启用却没调好优先级,结果保存一次,格式化完又被 ESLint 重排,再修复一遍——根本原因是默认格式化器和代码操作绑定错了。
- 关掉 Prettier 的自动格式化:
prettier.enable设为false - 把
editor.codeActionsOnSave设为{"source.fixAll.eslint": true},让 ESLint 负责修复 - 对
.vue文件类型单独指定格式化器:"[vue]": {"editor.defaultFormatter": "vue.volar"}(不是esbenp.prettier-vscode) - 项目根目录必须有
eslint.config.js(或.eslintrc.cjs),且files字段要包含'**/*.vue',否则 ESLint 根本不校验单文件组件
Settings Sync 同步插件列表:必须手动开启并验证
左下角显示 “Synced” 不代表插件已装上。默认不同步 extensions,即使你装了 50 个插件,新设备下载后仍是空白——这是最常被忽略的一步。
- 打开命令面板,运行
Sync: Advanced Options→Toggle Extension Sync,确认状态为 enabled - 再运行
Sync: Upload,此时extensions.json才会写入你的 GitHub Gist - 同步后去新设备执行
Sync: Download,插件是后台静默安装的,不报进度也不提示失败;可运行Sync: Show Output查日志,搜Installing extension -
python.defaultInterpreterPath这类绝对路径配置不能跨平台同步,建议留空或移到工作区.vscode/settings.json中,避免 Windows 路径同步到 macOS 后 Python 插件直接瘫痪
真正麻烦的从来不是“怎么装”,而是装完之后哪些配置悄悄失效:Volar 没接管、路径别名没对齐、ESLint 不校验 .vue、Sync 没开插件同步——每个点都得单独验证,少一个,开发体验就断一截。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










