前端团队协作规范如何落地,前端团队协作规范有哪些常见问题?
前端团队协作规范真正起作用,不靠一份厚文档,而靠三件事:提交前自动拦截、图表和文档能复用、工具成本算得清。规范要嵌进git提交、代码评审、组件文档和发布流程,否则就是wiki里的摆设。下面按代码、图表、文档、工具成本四块拆开讲,都是能直接照着改的操作路径。
前端团队代码规范怎么落地:把规则塞进提交链路
规范落地最怕两件事:规则只写在文档里,评审时靠人肉记。更稳的做法是把规则拆到工具链,让错误在提交前暴露。常见组合是ESLint管JS/TS、Stylelint管CSS、Prettier管格式、commitlint管提交信息,再用husky和lint-staged串起来。
提交前拦截:三步把检查跑起来
- 安装依赖:
pnpm add -D eslint prettier stylelint husky lint-staged @commitlint/cli @commitlint/config-conventional - 初始化钩子:
npx husky init,在.husky/pre-commit里写npx lint-staged;在.husky/commit-msg里写npx --no -- commitlint --edit $1。 - 在
package.json配lint-staged,只检查暂存文件:{"lint-staged":{"*.{js,ts,tsx}":["eslint --fix","prettier --write"],"*.{css,scss}":["stylelint --fix"]}}。
这样开发者不用记规则,提交时自动修。CI再跑一遍全量检查,防止绕过钩子。