როგორ აკონტროლებთ თქვენს პროექტში კოდის სტილის დაცვას?

ერთიანი კოდ-სტილის შენარჩუნებისთვის მე ვიყენებ შემდეგ ინსტრუმენტებს და პროცესებს:

1. ESLint: ვაკონფიგურებ კოდის ფორმატირების და ხარისხის წესებს (მაგალითად, Airbnb ან Standard). ESLint ეხმარება სინტაქსის შეცდომების გამოვლენაში, გადახრილების პრობლემებს, არასარგებლო ცვლადებს და ა.შ.

   // მაგალითი .eslintrc.js
   module.exports = {
     extends: 'airbnb-base', // ან სხვა არჩეული სტილი
     rules: {
       // წესების გადაფასება ან დამატება
       'semi': ['error', 'always'],
       'quotes': ['error', 'single']
     }
   };
   

2. Prettier: ინტეგრირებ Prettier-ს ავტომატური ფორმატირებისათვის. ის იღებს პასუხისმგებლობას სივრცეების, ხაზების გადატანების, წერტილებისა და სხვა დეტალების შესახებ, მუშაობს ESLint-თან (პლაგინების საშუალებით).

   // მაგალითი .prettierrc.json
   {
     "semi": true,
     "singleQuote": true,
     "printWidth": 100
   }
   

3. Husky და lint-staged: ვაკონფიგურებ pre-commit ჰუკებს Husky-ს საშუალებით. ლინტ-სტეიჯით ვახორციელებ ESLint და Prettier-ს მხოლოდ შეცვლილი ფაილებისთვის. ეს უზრუნველყოფს, რომ რეპოზიტორიაში მოხვდება მხოლოდ ფორმატირებული და შემოწმებული კოდი.

   // package.json-ის მაგალითი (ნაწილი)
   {
     "husky": {
       "hooks": {
         "pre-commit": "lint-staged"
       }
     },
     "lint-staged": {
       "*.{js,jsx,ts,tsx}": [
         "eslint --fix",
         "prettier --write"
       ],
       "*.{css,scss,less}": [
         "stylelint --fix", // თუ ვიყენებ Stylelint-ს
         "prettier --write"
       ],
       "*.{html,vue,svelte}": [
         "prettier --write"
       ]
     }
   }
   

4. კოდის მიმოხილვა: კოდის მიმოხილვის პროცესში ყურადღებას ვაქცევ დაწესებული შეთანხმებების დაცვას, თუნდაც ავტომატური ინსტრუმენტები რამე გამოტოვოს ან იყოს ნიუანსები, რომლებიც წესებს არ მოიცავს.

5. დოკუმენტაცია: ვუჭერ მინიმალურ დოკუმენტაციას მიღებულ კოდ-სტილზე პროექტში (მაგალითად, README ან CONTRIBUTING.md), რათა ახალი გუნდის წევრებმა სწრაფად გაეცნონ წესებს.

6. ინტეგრაცია IDE-ში: ვაკონფიგურებ რედაქტორებს (VS Code, WebStorm და ა.შ.) ავტომატური ფორმატირების და ESLint-ის შეცდომების პირდაპირ რედაქტორში ჩვენებისათვის.