(二)「造轮子」我也写了个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

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

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

到此环境配置基本完成

下一篇预告

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

相关推荐
小雨下雨的雨2 小时前
井字棋AI机器人实现详解 - Minimax算法实战-鸿蒙PC Electron框架完成
前端·人工智能·算法·华为·electron·鸿蒙
ZC跨境爬虫6 小时前
跟着 MDN 学JavaScript day_7:数学运算与逻辑判断实战测试
开发语言·前端·javascript·学习·ecmascript
fangdengfu1236 小时前
ES分析系统各个服务日志占用量
java·前端·elasticsearch
凌云拓界6 小时前
文件管理:让AI安全操作你的电脑 ——CogitoAgent开发实战(三)
javascript·人工智能·架构·开源·node.js
凌云拓界6 小时前
联网能力:让AI看见更广阔的世界 ——CogitoAgent开发实战(四)
javascript·人工智能·架构·node.js·创业创新
JustHappy7 小时前
古法编程秘籍(六):程序到底是怎么跑起来的?从 IO 到中断,一次讲明白
前端·后端·全栈
HYCS8 小时前
用pixi.js实现fabric.js(六):从线性代数的角度理解编辑器交互
前端·javascript·canvas
卷帘依旧8 小时前
useImperativeHandle的作用
前端
卷帘依旧8 小时前
Hooks在Fiber上的存储原理
前端