سؤال

مكان القراءة عن (أفضل الممارسات) في تنسيق كود المصدر، للغات الفردية، على سبيل المثال.ما هي اصطلاحات تسمية المتغيرات وما إلى ذلك، بالنسبة للمسافة البادئة ومكان وضع الأقواس، وكيف وأين يتم تضمين التعليقات، وما إلى ذلك.

على سبيل المثال لكتاب سي كيرنيغان وريتشي لغة البرمجة سي و لينوس تورفالدس دليل أسلوب ترميز نواة لينكس أو دليل أسلوب Google C++ وبالنسبة لبيرل على الأقل Perlstyle - دليل أسلوب بيرل.

يحرر:ربما كان ينبغي عليّ أن أسأل "كيف أبدأ بشكل جيد مع أنماط البرمجة".

هل كانت مفيدة؟

المحلول

وأود أن لا تعطي كثيرا على هذه النمط من أدلة. أنها بداية جيدة، ولكن في النهاية أنت أو فريقك سوف تتطور الخاصة الترميز-الأساليب.

وتحرير: أن الحارس روب كام تعليق، انه ترغب في معرفة المزيد عن هذه "انطلاق الاتفاقيات '

وهذا هو نقطة جيدة. ولكن في الغالب سوف تنضم المشاريع القائمة، المشاريع المفتوحة المصدر أو تجارية، والأشخاص الذين يعملون على أن يكون بالفعل على بعد اتفاقية الرمز. في شركة ربما موجود بالفعل اتفاقية الرمز. إذا كنت بدء مشروع جديد، وتبدأ مع اتفاقيات مشروع آخر فعلت من قبل.

إذا كنت حقا بدء مشروع جديد مع لغة جديدة لم تستخدم من قبل ... ثم قد تبدأ مع الاتفاقيات لغة أخرى مشابهة الى حد ما (أي لس س-لغة جديدة يمكنك استخدام الاتفاقيات من جاوة أو من Smalltalk) وتعديل الاتفاقيات الخاصة بك كما كنت اكتساب الخبرة للغة جديدة. كما بدأت البرمجة بلغة جافا كنت لي الترميز باسكال الاتفاقيات. لم بعض للاتفاقيات باسكال لا تعمل جيد جدا لجافا، ولكن مع الوقت الذي انخفض بعض الاتفاقيات القديمة وتطويرها جديد.

وكان S.Lott فكرة أن ننظر إلى المصدر، مشروع مفتوح مكتوب بلغة من اختيارك. هذه فكرة جيدة للحصول على بعض الاقتراحات حول اتفاقيات جيدة. كان سريكانث فكرة جيدة أن نسأل عن اتفاقيات جيدة هنا في ستاكوفيرفلوو. فكرة جيدة جدا، لأنه مع الوقت ستاكوفيرفلوو ستصبح مرجعا جيدا لالترميز الاتفاقيات بهذه الطريقة.

نصائح أخرى

ما هو أفضل من الكتاب هو لتحديد مكان شفرة المصدر المفتوح في لغتك المفضلة.

وبدلا من أن يكون الكتاب - عمل عدد قليل من الكتاب والمحررين - يعمل الكود هو مشروع المجتمع التي تلبي معايير المجتمع للغاية تطورت

وعندما سئل من قبل العميل للمساعدة في معايير التشفير، أنا أفضل أن نجد مشروعا مفتوح المصدر الجيد وتقديم وثيقة معايير القصيرة التي تقول "جعلها تبدو مثل XXX". وخير مثال التي تستخدم لأسلوب جافا أباتشي النملة المشروع.

ولكل فرد المفضلة لمشروعهم سبيل المثال مفتوح المصدر. قرأت بعض في العالم الحقيقي، رمز العمل، واختيار المفضلة لديك. محاكاة هذا المشروع.

وأود أن استخدام جوجل لذلك. على سبيل المثال، للبحث عن جافا المبادئ التوجيهية الترميز، وسوف تستخدم <لأ href = "http://www.google.com/search؟hl=en&q=Java+Coding+Standards&btnG=Google+Search&aq=f&oq=" يختلط = " نوفولو noreferrer "> هذا الاستعلام أو آخر في تجاوز المكدس ونسأل ما هي recommeded الترميز مبادئ توجيهية موحدة للجافا. من الصعب أن نشير إلى مصدر واحد لجميع اللغات.

وأود أن أقترح عليك أن تختار واحدة لشركتك / مشروع والعصا معه والتأكد من انها على مستوى جيد.

وأوصي حقا لقراءة كود النظيفة عمه بوب إذا هي تشعر بالقلق إزاء القضايا رمز نمط.

هناك ثلاثة أماكن جيدة للنظر فيها.

  1. كتب مشهورة باللغة التي تستخدمها.
  2. مشاريع مفتوحة المصدر مكتوبة بلغتك.
  3. أدوات مساعدة من نوع Checkstyle للغتك.

إذا كنت تستخدم أداة مثل Checkstyle أو PMD، فاعلم أن العديد من "القواعد" التي يفرضونها قد تكون مثيرة للجدل.قد يكون من المفيد أن تحقق من الوثائق لمعرفة القواعد التي يجب الحذر منها.

مايكروسوفت لديها وثيقة مرجعية مع الاتفاقيات الترميز الخاصة بهم والتي قد تكون مفيدة لننظر، حتى لو كنت لا تستخدم C #. ما وراء الاتفاقيات أسلوب والأساسية، وأفضل الكتب الممارسات الموصى بها من قبل الآخرين هنا، مثل كود النظيفة ، هي قراءة أساسية لخلق للصيانة، رمز للقراءة من شأنها أن تجعل معنى لمشرفون في المستقبل من قاعدة التعليمات البرمجية.

إذا كنت تستخدم Visual Studio (وبعض بيئات التطوير الحديثة الأخرى)، وتلقائيا أكدت التناقضات الأساسية مع الاتفاقيات الموصى بها (مع اقتراحات بشأن تحوم في الإصدارات الأخيرة من VS). في VS، إذا فريقك يريد استخدام معايير مختلفة، مجرد فتح خصائص المشروع وتغيير إعدادات "تحليل الرمز" (الماضي الأيسر عنصر القائمة). المزيد من هنا: <لأ href = "https://docs.microsoft.com/en-us/visualstudio/code-quality/using-rule-sets-to-group-code-analysis-rules؟f1url=https٪3A٪ 2F٪ 2Fmsdn.microsoft.com٪ 2Fquery٪ 2Fdev15.query٪ 3FappId٪ 3DDev15IDEF1٪ 26L٪ 3DEN للولايات المتحدة٪ 26K٪ 3Dk (vs.codeanalysis.rulesets.learnmore)٪ 3Bk (TargetFrameworkMoniker-.NETFramework٪ 2CVersion٪ 3Dv4.5) ٪ 26rd٪ 3Dtrue "يختلط =" نوفولو noreferrer "> استخدام القاعدة مجموعات لمجموعة التعليمات البرمجية تحليل قواعد

وأهلا ومرحبا يوم جيد للجميع

وحسنا يجب أن أقول أن ذلك يعتمد ذلك يعتمد على ما إذا كنت تعمل في شركة أو إذا كنت تعمل من أجلك.)

إذا كنت تعمل في شركة المصحف كنت موافقا على غرار تسمية والقواعد الأخرى

وبالنسبة لك، تحتاج فقط إلى وضع أسلوب أن الجميع بما فيهم أنت يمكن أن نفهم على الفور ماذا وكيف

والأقواس وغيرها هي طريقك

ولكن كما قلت هناك لغات الفردية بحيث يصبح لديهم قواعد الخاصة

ومثل Mnementh قال كل فريق أن يكون وسيلة لترميز ربما stricted أو بطريقة حرة

وهذا كل مع عدم وجود أكثر .... وداعا وداعا

وهناك أدلة على غرار C و C ++ ، صفحة قصيرة من الروابط إلى أدلة على غرار وقواعد الترميز، والمناقشات من USENET، التي تحتفظ بها كريستوفر لوت.

إذا كنت بي أتش بي المطور لا ينبغي تفويت هذين الدليلين:

مرخصة بموجب: CC-BY-SA مع الإسناد
لا تنتمي إلى StackOverflow
scroll top