Vue3 前端专属配置(VSCode settings.json + .prettierrc)

直接复制即用,完美适配 Vue3 + Vite + JavaScript/TypeScript 项目,解决格式化冲突、缩进、引号、换行等所有问题。


一、先确认你已安装这2个插件

打开 VSCode 扩展面板 Ctrl+Shift+X,安装:

  1. Vue Language Features (Volar) → Vue3 官方必备插件
  2. Prettier - Code formatter → 代码格式化核心插件

二、VSCode settings.json 配置(Vue3专用)

打开方式:

Ctrl+Shift+P → 输入 Open Settings (JSON) → 回车,全选替换下面代码:

json 复制代码
{
  // ==================== Vue3 核心格式化配置 ====================
  // 默认格式化工具 = Prettier
  "editor.defaultFormatter": "esbenp.prettier-vscode",
  // 保存文件时自动格式化(最实用)
  "editor.formatOnSave": true,
  // 粘贴代码自动格式化
  "editor.formatOnPaste": true,
  // 选中代码可手动格式化
  "editor.formatOnSelection": true,
  // 自动修复ESLint错误(配合格式化)
  "editor.codeActionsOnSave": {
    "source.fixAll.eslint": true
  },

  // ==================== 分语言指定格式化器 ====================
  "[vue]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },
  "[javascript]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },
  "[typescript]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },
  "[html]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },
  "[css]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },
  "[scss]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },
  "[json]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },

  // ==================== Vue3 语法优化 ====================
  // Volar 插件格式化支持
  "vue.autoInsertParentheses": true,
  // 关闭VSCode自带的格式化冲突
  "javascript.format.enable": false,
  "typescript.format.enable": false,
  // 缩进统一为2个空格(Vue3标准)
  "editor.tabSize": 2,
  "editor.insertSpaces": true
}

三、.prettierrc 配置文件(Vue3 团队标准)

使用方式:

在你的Vue3项目根目录 ,新建一个文件,命名为 .prettierrc,复制以下内容:

json 复制代码
{
  "printWidth": 120,            // 一行最大字符数(Vue3推荐)
  "tabWidth": 2,                // 缩进2空格(强制标准)
  "useTabs": false,             // 禁用Tab,用空格缩进
  "semi": true,                 // 语句末尾加分号
  "singleQuote": true,          // 使用单引号(Vue3标准)
  "quoteProps": "as-needed",    // 对象属性仅必要时加引号
  "jsxSingleQuote": true,       // JSX使用单引号
  "trailingComma": "es5",       // 末尾逗号(数组/对象保留)
  "bracketSpacing": true,      // 对象大括号内保留空格 { name: xxx }
  "bracketSameLine": false,    // HTML标签反尖括号单独一行(Vue标准)
  "arrowParens": "avoid",      // 箭头函数单参数省略括号
  "endOfLine": "lf",           // 换行符统一为LF(避免Windows/Mac冲突)
  "htmlWhitespaceSensitivity": "css" // HTML空格敏感度(不破坏布局)
}

四、格式化快捷键(Vue3 一键格式化)

  1. 格式化整个文件 :Shift + Alt + F(Windows)/ Shift + Option + F(Mac)
  2. 自动格式化 :直接按 Ctrl + S 保存文件,自动格式化代码
  3. 格式化选中代码 :选中代码 → 按 Shift + Alt + F

五、额外优化(可选,解决ESLint冲突)

如果你的Vue3项目用了 ESLint,执行这行命令安装兼容包:

bash 复制代码
npm install eslint-config-prettier eslint-plugin-prettier -D

然后在 .eslintrc.cjs 中添加:

js 复制代码
module.exports = {
  extends: [
    'plugin:vue/vue3-essential',
    'eslint:recommended',
    'plugin:prettier/recommended' // 关键:Prettier+ESLint兼容
  ]
}

总结

  1. 复制 settings.json → 配置VSCode格式化行为
  2. 项目根目录新建 .prettierrc → 统一Vue3代码风格
  3. 保存文件自动格式化,快捷键一键格式化
  4. 完美支持 Vue3 <script setup> 语法、CSS/Scss、TS/JS
相关推荐
叫个啥呢13 小时前
第一次写 DSH 插件:跟着自己的喜好实现个简单的代码管理插件
前端
掘金酱13 小时前
AI 带来的新生意|稀土掘金 X-Lab 年度大会招募开启
前端·后端·vibecoding
某哈压力大13 小时前
移动端 rem 适配
前端·vue.js·面试
泯泷13 小时前
Vercel AI SDK 6 完整教程系列 - 第一部分:基础入门篇
前端·javascript
lcy_2413 小时前
10 万条数据滚动不卡?聊聊我写的虚拟列表组件 vue-virtualize
前端
zhanlang021713 小时前
HTML 零基础入门到企业实战【第七章 7.5】表单验证基础属性:required、maxlength、placeholder
前端·html
涛涛ing14 小时前
为了快 30 倍,我把构建工具换成了 Rust,结果团队差点连班都加不了
前端
parade岁月14 小时前
SolidJS 2.0 正式发布:异步成为响应式的一部分
前端
lcy_2414 小时前
防抖节流、并发控制、指数退避重试——我把它收进了一个库 async-concurrency-kit
前端