المُنسِّقات

يُنسِّق OpenCode الملفات تلقائيا بعد كتابتها أو تعديلها باستخدام مُنسِّقات خاصة بكل لغة. يضمن ذلك أن الشيفرة التي يتم توليدها تتبع أساليب التنسيق المعتمدة في مشروعك.

---

مُضمَّنة

يأتي OpenCode مع عدة مُنسِّقات مُضمَّنة للغات وأطر العمل الشائعة. فيما يلي قائمة بالمُنسِّقات وامتدادات الملفات المدعومة والأوامر أو خيارات الإعداد التي تحتاجها.

المُنسِّق	الامتدادات	المتطلبات
gofmt	.go	يتوفر أمر gofmt
mix	.ex, .exs, .eex, .heex, .leex, .neex, .sface	يتوفر أمر mix
prettier	.js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml، وغير ذلك	وجود اعتماد prettier في package.json
biome	.js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml، وغير ذلك	ملف إعداد biome.json(c)
zig	.zig, .zon	يتوفر أمر zig
clang-format	.c, .cpp, .h, .hpp, .ino، وغير ذلك	ملف إعداد .clang-format
ktlint	.kt, .kts	يتوفر أمر ktlint
ruff	.py, .pyi	يتوفر أمر ruff مع إعداد
rustfmt	.rs	يتوفر أمر rustfmt
cargofmt	.rs	يتوفر أمر cargo fmt
uv	.py, .pyi	يتوفر أمر uv
rubocop	.rb, .rake, .gemspec, .ru	يتوفر أمر rubocop
standardrb	.rb, .rake, .gemspec, .ru	يتوفر أمر standardrb
htmlbeautifier	.erb, .html.erb	يتوفر أمر htmlbeautifier
air	.R	يتوفر أمر air
dart	.dart	يتوفر أمر dart
ocamlformat	.ml, .mli	يتوفر أمر ocamlformat وملف إعداد .ocamlformat
terraform	.tf, .tfvars	يتوفر أمر terraform
gleam	.gleam	يتوفر أمر gleam
nixfmt	.nix	يتوفر أمر nixfmt
shfmt	.sh, .bash	يتوفر أمر shfmt
pint	.php	وجود اعتماد laravel/pint في composer.json
oxfmt (Experimental)	.js, .jsx, .ts, .tsx	وجود اعتماد oxfmt في package.json وعلم متغير بيئة تجريبي
ormolu	.hs	يتوفر أمر ormolu

لذا إذا كان مشروعك يتضمن prettier ضمن package.json، فسيستخدمه OpenCode تلقائيا.

---

كيف يعمل

عندما يكتب OpenCode ملفا أو يحرره، فإنه:

1. يتحقق من امتداد الملف مقابل جميع المُنسِّقات المفعّلة.
2. يشغّل أمر المُنسِّق المناسب على الملف.
3. يطبق تغييرات التنسيق تلقائيا.

تتم هذه العملية في الخلفية لضمان الحفاظ على أساليب تنسيق الشيفرة دون أي خطوات يدوية.

---

الإعداد

يمكنك تخصيص المُنسِّقات عبر قسم formatter في إعدادات OpenCode.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "formatter": {}
}

يدعم إعداد كل مُنسِّق ما يلي:

الخاصية	النوع	الوصف
disabled	boolean	اضبطها على true لتعطيل المُنسِّق
command	string[]	الأمر الذي سيتم تشغيله للتنسيق
environment	object	متغيرات البيئة التي يتم ضبطها عند تشغيل المُنسِّق
extensions	string[]	امتدادات الملفات التي يجب أن يتعامل معها هذا المُنسِّق

لنلقِ نظرة على بعض الأمثلة.

---

تعطيل المُنسِّقات

لتعطيل جميع المُنسِّقات على مستوى عام، اضبط formatter على false:

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "formatter": false
}

لتعطيل مُنسِّق محدد، اضبط disabled على true:

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "formatter": {
    "prettier": {
      "disabled": true
    }
  }
}

---

مُنسِّقات مخصّصة

يمكنك تجاوز المُنسِّقات المُضمَّنة أو إضافة مُنسِّقات جديدة عبر تحديد الأمر ومتغيرات البيئة وامتدادات الملفات:

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "formatter": {
    "prettier": {
      "command": ["npx", "prettier", "--write", "$FILE"],
      "environment": {
        "NODE_ENV": "development"
      },
      "extensions": [".js", ".ts", ".jsx", ".tsx"]
    },
    "custom-markdown-formatter": {
      "command": ["deno", "fmt", "$FILE"],
      "extensions": [".md"]
    }
  }
}

سيتم استبدال العنصر النائب $FILE في الأمر بمسار الملف الذي يجري تنسيقه.