vite创建一个ts + vue3 项目 📚

一、vite创建一个ts + vue3 项目

          
1
          $ npm create vite@latest

        

          
1
          $ yarn create vite

        

          
1
          $ pnpm create vite

        

二、代码格式化工具（Prettier）

1、下载安装 prettier：

          
1
          npm install --save-dev --save-exact prettier

        

配置选项的 Prettier 文档

2、安装 Vscode 插件（Prettier）：

3、配置 Prettier：

          
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
          // @see: https://www.prettier.cn

module.exports = {
    // 超过最大值换行
    printWidth: 130,
    // 缩进字节数
    tabWidth: 2,
    // 使用制表符而不是空格缩进行
    useTabs: true,
    // 结尾不用分号(true有，false没有)
    semi: true,
    // 使用单引号(true单双引号，false双引号)
    singleQuote: false,
    // 更改引用对象属性的时间 可选值"<as-needed|consistent|preserve>"
    quoteProps: "as-needed",
    // 在对象，数组括号与文字之间加空格 "{ foo: bar }"
    bracketSpacing: true,
    // 多行时尽可能打印尾随逗号。（例如，单行数组永远不会出现逗号结尾。） 可选值"<none|es5|all>"，默认none
    trailingComma: "none",
    // 在JSX中使用单引号而不是双引号
    jsxSingleQuote: false,
    //  (x) => {} 箭头函数参数只有一个时是否要有小括号。avoid：省略括号 ,always：不省略括号
    arrowParens: "avoid",
    // 如果文件顶部已经有一个 doclock，这个选项将新建一行注释，并打上@format标记。
    insertPragma: false,
    // 指定要使用的解析器，不需要写文件开头的 @prettier
    requirePragma: false,
    // 默认值。因为使用了一些折行敏感型的渲染器（如GitHub comment）而按照markdown文本样式进行折行
    proseWrap: "preserve",
    // 在html中空格是否是敏感的 "css" - 遵守CSS显示属性的默认值， "strict" - 空格被认为是敏感的 ，"ignore" - 空格被认为是不敏感的
    htmlWhitespaceSensitivity: "css",
    // 换行符使用 lf 结尾是 可选值"<auto|lf|crlf|cr>"
    endOfLine: "auto",
    // 这两个选项可用于格式化以给定字符偏移量（分别包括和不包括）开始和结束的代码
    rangeStart: 0,
    rangeEnd: Infinity,
    // Vue文件脚本和样式标签缩进
    vueIndentScriptAndStyle: false
};

        

三、代码规范工具（ESLint）

1、安装 ESLint 相关插件：

          
1
          npm install eslint eslint-config-prettier eslint-plugin-prettier eslint-plugin-vue @typescript-eslint/eslint-plugin @typescript-eslint/parser -D

        

通过导入插件注册插件并将其添加为插件vite.config.js,任何 ESLint 错误现在都会在浏览器中报告！

          
1
2
3
4
5
6
          import { defineConfig } from 'vite';
import eslintPlugin from 'vite-plugin-eslint';

export default defineConfig({
  plugins: [eslintPlugin()],
});

        

2、安装 Vscode 插件（ESLint、TSLint）：

• ESLint

• TSLint

3、配置 ESLint：

          
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
          // @see: http://eslint.cn

module.exports = {
    root: true,
    env: {
        browser: true,
        node: true,
        es6: true
    },
    /* 指定如何解析语法 */
    parser: "vue-eslint-parser",
    /* 优先级低于 parse 的语法解析配置 */
    parserOptions: {
        parser: "@typescript-eslint/parser",
        ecmaVersion: 2020,
        sourceType: "module",
        jsxPragma: "React",
        ecmaFeatures: {
            jsx: true
        }
    },
    /* 继承某些已有的规则 */
    extends: ["plugin:vue/vue3-recommended", "plugin:@typescript-eslint/recommended", "prettier", "plugin:prettier/recommended"],
    /*
     * "off" 或 0    ==>  关闭规则
     * "warn" 或 1   ==>  打开的规则作为警告（不影响代码执行）
     * "error" 或 2  ==>  规则作为一个错误（代码不能执行，界面报错）
     */
    rules: {
        // eslint (http://eslint.cn/docs/rules)
        "no-var": "error", // 要求使用 let 或 const 而不是 var
        "no-multiple-empty-lines": ["error", { max: 1 }], // 不允许多个空行
        "no-use-before-define": "off", // 禁止在 函数/类/变量 定义之前使用它们
        "prefer-const": "off", // 此规则旨在标记使用 let 关键字声明但在初始分配后从未重新分配的变量，要求使用 const
        "no-irregular-whitespace": "off", // 禁止不规则的空白

        // typeScript (https://typescript-eslint.io/rules)
        "@typescript-eslint/no-unused-vars": "error", // 禁止定义未使用的变量
        "@typescript-eslint/no-inferrable-types": "off", // 可以轻松推断的显式类型可能会增加不必要的冗长
        "@typescript-eslint/no-namespace": "off", // 禁止使用自定义 TypeScript 模块和命名空间。
        "@typescript-eslint/no-explicit-any": "off", // 禁止使用 any 类型
        "@typescript-eslint/ban-ts-ignore": "off", // 禁止使用 @ts-ignore
        "@typescript-eslint/ban-types": "off", // 禁止使用特定类型
        "@typescript-eslint/explicit-function-return-type": "off", // 不允许对初始化为数字、字符串或布尔值的变量或参数进行显式类型声明
        "@typescript-eslint/no-var-requires": "off", // 不允许在 import 语句中使用 require 语句
        "@typescript-eslint/no-empty-function": "off", // 禁止空函数
        "@typescript-eslint/no-use-before-define": "off", // 禁止在变量定义之前使用它们
        "@typescript-eslint/ban-ts-comment": "off", // 禁止 @ts-<directive> 使用注释或要求在指令后进行描述
        "@typescript-eslint/no-non-null-assertion": "off", // 不允许使用后缀运算符的非空断言(!)
        "@typescript-eslint/explicit-module-boundary-types": "off", // 要求导出函数和类的公共类方法的显式返回和参数类型

        // vue (https://eslint.vuejs.org/rules)
        "vue/script-setup-uses-vars": "error", // 防止<script setup>使用的变量<template>被标记为未使用，此规则仅在启用该no-unused-vars规则时有效。
        "vue/v-slot-style": "error", // 强制执行 v-slot 指令样式
        "vue/no-mutating-props": "off", // 不允许组件 prop的改变（明天找原因）
        "vue/custom-event-name-casing": "off", // 为自定义事件名称强制使用特定大小写
        "vue/attributes-order": "off", // vue api使用顺序，强制执行属性顺序
        "vue/one-component-per-file": "off", // 强制每个组件都应该在自己的文件中
        "vue/html-closing-bracket-newline": "off", // 在标签的右括号之前要求或禁止换行
        "vue/max-attributes-per-line": "off", // 强制每行的最大属性数
        "vue/multiline-html-element-content-newline": "off", // 在多行元素的内容之前和之后需要换行符
        "vue/singleline-html-element-content-newline": "off", // 在单行元素的内容之前和之后需要换行符
        "vue/attribute-hyphenation": "off", // 对模板中的自定义组件强制执行属性命名样式
        "vue/require-default-prop": "off", // 此规则要求为每个 prop 为必填时，必须提供默认值
        "vue/multi-word-component-names": "off" // 要求组件名称始终为 “-” 链接的单词
    }
};

        

四、样式规范工具（StyleLint）

1、安装 StyleLint 相关插件：

          
1
          npm i stylelint stylelint-config-html stylelint-config-recommended-scss stylelint-config-recommended-vue stylelint-config-standard stylelint-config-standard-scss stylelint-order postcss postcss-html stylelint-config-prettier -D

        

若使用less或其他将sass改成less

2、安装 Vscode 插件（Stylelint）：

3、在目录的 .vscode 文件中新建 settings.json：

          
1
2
3
4
5
6
7
          {
    "stylelint.enable": true,
    "editor.codeActionsOnSave": {
        "source.fixAll.stylelint": true
    },
    "stylelint.validate": ["css", "less", "postcss", "scss", "vue", "sass", "html"]
}

        

😎 也可以在 vscode 中全局配置上述 json 代码 😎

4、配置 stylelint.config.js

          
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
          // @see: https://stylelint.io

module.exports = {
    /* 继承某些已有的规则 */
    extends: [
        "stylelint-config-standard",
        "stylelint-config-html/vue",
        "stylelint-config-standard-scss",
        "stylelint-config-recommended-vue/scss",
        "stylelint-config-prettier"
    ],
    /* 使用排序插件 */
    plugins: ["stylelint-order"],
    overrides: [
        // 扫描 .vue/html 文件中的<style>标签内的样式
        {
            files: ["**/*.{vue,html}"],
            customSyntax: "postcss-html"
        }
    ],
    /**
     * null  => 关闭该规则
     */
    rules: {
        indentation: null, // 指定缩进空格
        "no-descending-specificity": null, // 禁止在具有较高优先级的选择器后出现被其覆盖的较低优先级的选择器
        "function-url-quotes": "always", // 要求或禁止 URL 的引号 "always(必须加上引号)"|"never(没有引号)"
        "string-quotes": "double", // 指定字符串使用单引号或双引号
        "unit-case": null, // 指定单位的大小写 "lower(全小写)"|"upper(全大写)"
        "color-hex-case": "lower", // 指定 16 进制颜色的大小写 "lower(全小写)"|"upper(全大写)"
        "color-hex-length": "long", // 指定 16 进制颜色的简写或扩写 "short(16进制简写)"|"long(16进制扩写)"
        "rule-empty-line-before": "never", // 要求或禁止在规则之前的空行 "always(规则之前必须始终有一个空行)"|"never(规则前绝不能有空行)"|"always-multi-line(多行规则之前必须始终有一个空行)"|"never-multi-line(多行规则之前绝不能有空行。)"
        "font-family-no-missing-generic-family-keyword": null, // 禁止在字体族名称列表中缺少通用字体族关键字
        "block-opening-brace-space-before": "always", // 要求在块的开大括号之前必须有一个空格或不能有空白符 "always(大括号前必须始终有一个空格)"|"never(左大括号之前绝不能有空格)"|"always-single-line(在单行块中的左大括号之前必须始终有一个空格)"|"never-single-line(在单行块中的左大括号之前绝不能有空格)"|"always-multi-line(在多行块中，左大括号之前必须始终有一个空格)"|"never-multi-line(多行块中的左大括号之前绝不能有空格)"
        "property-no-unknown": null, // 禁止未知的属性(true 为不允许)
        "no-empty-source": null, // 禁止空源码
        "declaration-block-trailing-semicolon": null, // 要求或不允许在声明块中使用尾随分号 string："always(必须始终有一个尾随分号)"|"never(不得有尾随分号)"
        "selector-pseudo-class-no-unknown": [
            true,
            {
                ignorePseudoClasses: ["deep"]
            }
        ],
        // 样式的排序规则
        "order/properties-order": [
            "position",
            "top",
            "right",
            "bottom",
            "left",
            "z-index",
            "display",
            "justify-content",
            "align-items",
            "float",
            "clear",
            "overflow",
            "overflow-x",
            "overflow-y",
            "margin",
            "margin-top",
            "margin-right",
            "margin-bottom",
            "margin-left",
            "padding",
            "padding-top",
            "padding-right",
            "padding-bottom",
            "padding-left",
            "width",
            "min-width",
            "max-width",
            "height",
            "min-height",
            "max-height",
            "font-size",
            "font-family",
            "font-weight",
            "border",
            "border-style",
            "border-width",
            "border-color",
            "border-top",
            "border-top-style",
            "border-top-width",
            "border-top-color",
            "border-right",
            "border-right-style",
            "border-right-width",
            "border-right-color",
            "border-bottom",
            "border-bottom-style",
            "border-bottom-width",
            "border-bottom-color",
            "border-left",
            "border-left-style",
            "border-left-width",
            "border-left-color",
            "border-radius",
            "text-align",
            "text-justify",
            "text-indent",
            "text-overflow",
            "text-decoration",
            "white-space",
            "color",
            "background",
            "background-position",
            "background-repeat",
            "background-size",
            "background-color",
            "background-clip",
            "opacity",
            "filter",
            "list-style",
            "outline",
            "visibility",
            "box-shadow",
            "text-shadow",
            "resize",
            "transition"
        ]
    }
};

        

五、EditorConfig 配置

1、简介

EditorConfig 帮助开发人员在 不同的编辑器 和 IDE 之间定义和维护一致的编码样式。

2、安装 VsCode 插件（EditorConfig ）：

3、配置 EditorConfig：

          
1
2
3
4
5
6
7
8
9
10
11
12
13
14
          # http://editorconfig.org
root = true

[*] # 表示所有文件适用
charset = utf-8 # 设置文件字符集为 utf-8
end_of_line = lf # 控制换行类型(lf | cr | crlf)
insert_final_newline = true # 始终在文件末尾插入一个新行
indent_style = tab # 缩进风格（tab | space）
indent_size = 2 # 缩进大小
max_line_length = 130 # 最大行长度

[*.md] # 表示仅 md 文件适用以下规则
max_line_length = off # 关闭最大行长度限制
trim_trailing_whitespace = false # 关闭末尾空格修剪