(二)「造轮子」我也写了个Vue3脚手架!(项目环境搭建)

(一)「造轮子」我也写了个Vue3脚手架!(整体介绍)

(二)「造轮子」我也写了个Vue3脚手架!(项目环境搭建)

本期介绍内容如下

项目初始化
prettier配置
husky和lint-staged配置

代码的

项目环境搭建

1. 项目初始化和开发依赖安装

建立好我的文件夹,我的项目就叫create-jqq

bash 复制代码
mkdir create-jqq
cd create-jqq

我需要生成下package.json

bash 复制代码
npm init -y

修改一下package.json的内容

  • "type": "module" :指定该包中的 JavaScript 文件应该作为 ES 模块 (ESM) 而不是 CommonJS (CJS) 模块来处理
  • binbin 字段用于指定当你的包安装时,应该创建哪些可执行命令
    • 当包全局安装时(npm install -g xxx),npm 会创建一个符号链接从全局的 bin 目录指向你指定的文件。这样用户可以直接在命令行中运行 create-jqq 命令
    • 本地安装(作为项目依赖),bin 指定的命令也会被链接到 ./node_modules/.bin/ 目录。可以通过 npx create-jqq 或 npm scripts 使用
    • 当然,对应的./index.js的第一行,需要指定#!/usr/bin/env node,表明文件在node环境下进行运行
package.json 复制代码
{
  "name": "create-jqq",
  "version": "0.0.0",
  "type": "module",
  "bin": {
    "create-jqq": "./index.js"
  },
  "scripts": {
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  "description": ""
}

安装一下开发依赖(对应依赖项的作用已经在第一篇文章中有介绍)

  • 代码规范有关的依赖本文后面讲述安装,打包有关的依赖先不进行安装,后续专门文章讲打包发布的时候再进行安装。
  • 最终会把所有的依赖项都打包到一个js文件中,才好方便发布了之后能直接运行,所以这里直接-D安装到开发依赖中即可
bash 复制代码
npm install -D commander inquirer ora chalk @types/ejs ejs @types/lodash-es lodash-es @types/fs-extra fs-extra esno @types/node

再初始化一下git,新建一下.gitignore文件,忽略node_modules文件夹

bash 复制代码
git init
> .gitignore
echo "node_modules" > .gitignore

新建index.ts文件,在package.json中使用esno运行index.ts文件,执行命令即可在控制台输出结果了

index.ts 复制代码
> index.ts
echo "console.log('test esno')" > index.ts
package.json 复制代码
{
  "scripts": {
    "create": "npx esno ./index.ts"
  },
}

😊到这里我们就能正常运行index.ts文件了~

2. 代码规范配置

prettier格式化代码

prettier配置,可直接移步官方文档查看

bash 复制代码
npm install --save-dev --save-exact prettier

新建 .prettierrc 文件

  • "semi": false 是否在语句末尾添加分号(false表示不加分号)
  • "singleQuote": true 是否使用单引号,true是使用
  • "printWidth": 100 每行代码的最大宽度,超过了会自动换行
.prettierrc 复制代码
{
  "semi": false,
  "singleQuote": true,
  "printWidth": 100
}

新建 .prettierignore 文件,添加一下不需要格式化的文件

.prettierignore 复制代码
package.json
package-lock.json

package.json添加格式化命令

package.json 复制代码
"scripts": {
  "create": "npx esno ./index.ts",
  "format": "prettier --write ."
},

测试一下命令,给index.ts文件多增加一下空行 然后执行 npm run format 可以看到已经格式化了对应的文件

添加一下 .gitattributes 文件,增加如下的配置,用来确保项目中的所有文本文件使用 LF 换行符,并自动保护二进制文件,提升团队协作一致性。 Prettier 默认强制使用 LF(Unix 风格换行符),和Prettier 协作时,主要通过 统一换行符避免格式化冲突 来提升开发效率

.gitattributes 复制代码
* text=auto eol=lf

到这里我们的prettier还不能在保存的时候自动格式化代码,我们就新建一下 .vscode/settings.json 文件。加入如下配置的时候就可以发现保存的时候会自动格式化啦,可以在.index.ts文件中多加一个换行然后 ctrl+s 保存一下代码就可以看到效果

settings.json 复制代码
{
  "editor.formatOnSave": true,
  "editor.defaultFormatter": "esbenp.prettier-vscode"
}

顺便在添加一下插件推荐吧,新建.vscode/extensions.json

extensions.json 复制代码
{
  "recommendations": ["esbenp.prettier-vscode"]
}

husky 和 lint-staged

husky 安装(Husky 能使你的提交变得更好 🐶 汪! 在提交或推送时,自动化 检查提交信息检查代码运行测试。)

bash 复制代码
npm install --save-dev husky
npx husky init

lint-staged 是一个用于在 Git 暂存区的文件上运行代码检查(linting)工具的工具。 它通过只对已经暂存(即通过 git add)的文件进行操作。

bash 复制代码
npm install --save-dev lint-staged

添加lint-staged配置

package.json 复制代码
"lint-staged": {
  "*.{js,ts,vue,json}": [
    "prettier --write"
  ]
}

修改.husky/pre-commit文件

复制代码
npx lint-staged

执行一下代码提交看下效果,配置是生效了的

😊😊😊😊😊😊😊😊😊😊😊😊😊😊😊😊😊

到此环境配置基本完成

下一篇预告

我们将实现脚手架命令行读取配置相关功能,🚀敬请期待🚀

相关推荐
海天胜景1 分钟前
vue3 el-table 行筛选 设置为单选
javascript·vue.js·elementui
今天又在摸鱼2 分钟前
Vue3-组件化-Vue核心思想之一
前端·javascript·vue.js
蓝婷儿4 分钟前
每天一个前端小知识 Day 21 - 浏览器兼容性与 Polyfill 策略
前端
百锦再6 分钟前
Vue中对象赋值问题:对象引用被保留,仅部分属性被覆盖
前端·javascript·vue.js·vue·web·reactive·ref
jingling55510 分钟前
面试版-前端开发核心知识
开发语言·前端·javascript·vue.js·面试·前端框架
拾光拾趣录15 分钟前
CSS 深入解析:提升网页样式技巧与常见问题解决方案
前端·css
莫空000016 分钟前
深入理解JavaScript属性描述符:从数据属性到存取器属性
前端·面试
guojl17 分钟前
深度剖析Kafka读写机制
前端
FogLetter17 分钟前
图片懒加载:让网页飞起来的魔法技巧 ✨
前端·javascript·css
Mxuan18 分钟前
vscode webview 插件开发(精装篇)
前端