摘要：搭建自己的前端腳手架一般新開(kāi)發(fā)一個(gè)項(xiàng)目時(shí)，我們會(huì)首先搭建好一個(gè)腳手架，然后才會(huì)開(kāi)始寫代碼。搭建腳手架可以用等命令行工具，也可以直接用等模板，如果這些都不能滿足你的個(gè)性化需求，可以嘗試搭建自己的前端腳手架。

一般新開(kāi)發(fā)一個(gè)項(xiàng)目時(shí)，我們會(huì)首先搭建好一個(gè)腳手架，然后才會(huì)開(kāi)始寫代碼。搭建腳手架可以用 create-react-app、vue-cli、yeoman 等命令行工具，也可以直接用 html5-boilerplate、react-boilerplate、hackathon-starter 等模板，如果這些都不能滿足你的個(gè)性化需求，可以嘗試搭建自己的前端腳手架。

一般來(lái)說(shuō)，腳手架包括目錄結(jié)構(gòu)定義、必要的項(xiàng)目配置文件與工具配置文件、工具與命令。

一個(gè)基本的腳手架：

|-- /                              項(xiàng)目根目錄
    |-- src/                       源代碼目錄
    |-- package.json               npm 項(xiàng)目文件
    |-- README.md                  項(xiàng)目說(shuō)明文件
    |-- CHANGELOG.md               版本更新記錄
    |-- .gitignore                 git 忽略配置文件
    |-- .editorconfig              編輯器配置文件
    |-- .npmrc                     npm 配置文件
    |-- .npmignore                 npm 忽略配置文件
    |-- .eslintrc                  eslint 配置文件
    |-- .eslintignore              eslint 忽略配置文件
    |-- .stylelintrc               stylelint 配置文件
    |-- .stylelintignore           stylelint 忽略配置文件
    |-- .prettierrc                prettier 配置文件
    |-- .prettierignore            prettier 忽略配置文件
    
    |-- .babelrc                   babel 配置文件
    |-- webpack.config.js          webpack 配置文件
    |-- rollup.config.js           rollup 配置文件
    |-- gulpfile.js                gulp 配置文件

一些擴(kuò)展的腳手架：

|-- /                              項(xiàng)目根目錄
    |-- bin/                       bin 目錄
    |-- test/                      測(cè)試目錄
    |-- docs/                      文檔目錄
    |-- jest.config.js             jest 配置文件
    |-- .gitattributes             git 屬性配置
    |-- .travis.yml                travis 配置文件
    |-- appveyor.yml               appveyor 配置文件

{
  "name": "name",                  項(xiàng)目名字
  "version": "0.0.1",              版本
  "main": "index.js",              入口文件
  "bin": "bin/bin.js",             bin 文件
  "description": "description",    描述
  "repository": {                  
    "type": "git",
    "url": "url"
  },
  "keywords": [],
  "homepage": "homepage",          主頁(yè)
  "readmeFilename": "README.md",
  "devDependencies": {             工具依賴
    "babel-eslint": "^8.2.6",
    "eslint": "^4.19.1",
    "husky": "^0.14.3",
    "lint-staged": "^7.2.0",
    "prettier": "^1.14.0",
    "stylelint": "^9.3.0",
    "eslint-config-airbnb": "^17.0.0",
    "eslint-config-prettier": "^2.9.0",
    "eslint-plugin-babel": "^5.1.0",
    "eslint-plugin-import": "^2.13.0",
    "eslint-plugin-jsx-a11y": "^6.1.0",
    "eslint-plugin-prettier": "^2.6.2",
    "eslint-plugin-react": "^7.10.0",
    "stylelint-config-prettier": "^3.3.0",
    "stylelint-config-standard": "^18.2.0"
  },
  "scripts": {                     可以添加更多命令
    "precommit": "npm run lint-staged",
    "prettier": "prettier --write "./**/*.{js,jsx,css,less,md,json}"",
    "eslint": "eslint .",
    "eslint:fix": "eslint . --fix",
    "stylelint": "stylelint "./**/*.{css,less}"",
    "stylelint:fix": "stylelint "./**/*.{css,less}" --fix",
    "lint-staged": "lint-staged"
  },
  "lint-staged": {                 對(duì)提交的代碼進(jìn)行檢查與矯正
    "**/*.{js,jsx}": [
      "eslint --fix",
      "prettier --write",
      "git add"
    ],
    "**/*.{css,less}": [
      "stylelint --fix",
      "prettier --write",
      "git add"
    ],
    "**/*.{md,json}": [
      "prettier --write",
      "git add"
    ]
  },
  "engines": {                     運(yùn)行時(shí)對(duì) node 版本的要求
    "node": ">=8.0.0"
  },
  "dependencies": {}               開(kāi)發(fā)依賴
}

如果你將當(dāng)前的項(xiàng)目發(fā)布為一個(gè) npm 包，而其他的包在引用你的包時(shí)，構(gòu)建工具就會(huì)去找 main 字段定義的入口文件，詳細(xì)參考 package.json#main。

還有其他的特殊的入口文件，參考 package.json 非官方字段集合。

如果你需要將當(dāng)前的項(xiàng)目安裝成一個(gè)全局的命令，那么就需要指定這個(gè)字段。

詳細(xì)信息參考 package.json#bin。

這里定義的命令可以用 npm run 來(lái)調(diào)用。比如上面定義的幾個(gè)命令：

npm run prettier
npm run eslint
npm run eslint:fix
npm run stylelint
npm run stylelint:fix

一般來(lái)說(shuō)，還可能定義如下的一些命令：

{
  "test": "",                      測(cè)試  
  "build": "",                     構(gòu)建
  "dev": "",                       開(kāi)發(fā)
  ...
}

項(xiàng)目說(shuō)明的入口文件，包括文檔。一般 git 項(xiàng)目 web 端首頁(yè)顯示的就是這個(gè)文件的內(nèi)容，包括 github、bitbucket、gitlab。

文件格式是 markdown，具體介紹與語(yǔ)法可以參考 https://www.markdownguide.org/。

一般項(xiàng)目都會(huì)有這個(gè)文件，用于記錄版本更新及相應(yīng)的功能變化，比如 react 的 CHANGELOG。

文件格式也是 markdown。

用于指定哪些文件或目錄不需要進(jìn)行 git 版本控制。

比如:

.DS_STORE
node_modules
build/
*.log*
.idea
.vscode

詳細(xì)信息參考 https://git-scm.com/docs/gitignore。

用于指定編輯器特定的配置。比如，不同的編輯器對(duì) tab 的定義不一樣，可能是 2 個(gè)空格，也可能是 4 個(gè)或者 8 個(gè)，所以就需要用這個(gè)文件來(lái)統(tǒng)一配置編輯器。

比如:

# http://editorconfig.org
root = true

[*]
indent_style = space
indent_size = 2
end_of_line = lf
charset = utf-8
trim_trailing_whitespace = true
insert_final_newline = true

[*.md]
trim_trailing_whitespace = false

詳細(xì)信息參考 http://editorconfig.org。

比如:

package-lock=false

詳細(xì)信息參考 https://www.npmjs.com.cn/files/npmrc/。

詳細(xì)信息參考 keeping-files-out-of-your-package。

用于 js, jsx 代碼檢查與矯正，讓你編寫的代碼符合特定的規(guī)范與風(fēng)格。

詳細(xì)信息參考 https://eslint.org/。

用于 css, less, scss 代碼檢查與矯正，讓你編寫的代碼符合特定的規(guī)范與風(fēng)格。

詳細(xì)信息參考 https://stylelint.io/。

優(yōu)化 js, jsx, css, less, scss, md, json 等文件的格式。

詳細(xì)信息參考 https://prettier.io/。

es6 -> es5 轉(zhuǎn)碼。

詳細(xì)信息參考 https://babeljs.io/。

前端打包工具。

詳細(xì)信息參考 https://webpack.js.org/。

另一個(gè)前端打包工具。

詳細(xì)信息參考 https://rollupjs.org/。

前端文件流操作構(gòu)建工具。

詳細(xì)信息參考 https://www.gulpjs.com/。

前端測(cè)試組件。

詳細(xì)信息參考 https://jestjs.io/。

詳細(xì)信息參考 https://git-scm.com/docs/gitattributes。

一個(gè)持續(xù)集成服務(wù)。

詳細(xì)信息參考 https://www.travis-ci.org/。

又一個(gè)持續(xù)集成服務(wù)。

詳細(xì)信息參考 https://www.appveyor.com/。

更多博客，查看 https://github.com/senntyou/blogs

作者：深予之 (@senntyou)

版權(quán)聲明：自由轉(zhuǎn)載-非商用-非衍生-保持署名（創(chuàng)意共享3.0許可證）