การวิเคราะห์เชิงลึกของไฟล์ package.json

ทำความเข้าใจ package.json

ภายใต้ไดเร็กทอรีรากของแต่ละโปรเจ็กต์ (แพ็คเกจที่ดาวน์โหลดจาก npm หรือโปรเจ็กต์ nodejs อื่นๆ) โดยทั่วไปจะมีไฟล์ package.json ซึ่งกำหนดโมดูลต่างๆ ที่จำเป็นสำหรับโปรเจ็กต์ รวมถึงข้อมูลการกำหนดค่าโปรเจ็กต์ ( ข้อมูลเมตา เช่น ชื่อ เวอร์ชัน ใบอนุญาต วิธีเริ่มโปรเจ็กต์ รันสคริปต์ ฯลฯ) คำสั่ง npm install จะดาวน์โหลดโมดูลที่จำเป็นโดยอัตโนมัติตามไฟล์คอนฟิกูเรชันนี้

ไฟล์ package.json เป็นออบเจ็กต์ JSON และสมาชิกของออบเจ็กต์แต่ละรายการคือการตั้งค่าของโปรเจ็กต์ปัจจุบัน ตัวอย่างเช่น name คือชื่อโปรเจ็กต์ version คือเวอร์ชัน (ตามรูปแบบของ "major version.minor version.minor version") นอกจากนี้ยังจะมีบทบาทหลายอย่างในวงจรชีวิตของโครงการ รวมถึงการพัฒนา การทดสอบ และเวอร์ชันออนไลน์

package.json ทำหน้าที่

• เป็นไฟล์คำอธิบายที่อธิบายแพ็คเกจที่โปรเจ็กต์ของคุณใช้อยู่
• ช่วยให้เราใช้ "กฎการกำหนดเวอร์ชันเชิงความหมาย" (จะอธิบายในภายหลัง) เพื่อระบุเวอร์ชันของแพ็กเกจที่ขึ้นต่อกันของโปรเจ็กต์ของคุณ
• เพื่อให้บิลด์ของคุณสามารถสื่อสารกับนักพัฒนารายอื่นได้ดียิ่งขึ้น . แชร์เพื่อนำมาใช้ใหม่อย่างง่ายดาย

วิธีสร้าง package.json

1. ใช้เครื่องมือบรรทัดคำสั่ง CLI

npm init

ซึ่งจะเริ่มต้นแบบสอบถามบรรทัดคำสั่ง ซึ่งจะสร้าง package.json ในไดเร็กทอรีที่คุณเริ่มคำสั่ง

การเข้าสู่หลักสูตรความเชี่ยวชาญส่วนหน้า (vue): เข้าสู่การเรียนรู้

2. สร้างค่าเริ่มต้น

หากต้องการรับค่าเริ่มต้น package.json โปรดรัน npm init ด้วยแฟล็ก --yes หรือ -y :

npm init -y

วิธีการนี้จะใช้ package.json จากข้อมูลปัจจุบัน ข้อมูลที่ดึงมาจากไดเร็กทอรีจะสร้างค่าเริ่มต้น โดยข้ามขั้นตอนการตอบคำถาม

3. สร้าง

ไฟล์ package.json ใหม่ด้วยตนเองโดยตรงในไดเร็กทอรีรากของโปรเจ็กต์ จากนั้นป้อนเนื้อหาที่เกี่ยวข้อง โปรดดูหมายเหตุใน package.json ด้านล่างสำหรับรายละเอียด

คำอธิบายโดยละเอียดของฟิลด์ทั่วไปในไฟล์ package.json

1. ชื่อ

เป็นฟิลด์บังคับ ซึ่งเป็นชื่อของโมดูลปัจจุบันแพ็คเกจ ความยาวต้องน้อยกว่าหรือเท่ากับ 214 อักขระ โดยไม่สามารถขึ้นต้นด้วย "." ) หรือ "_" (ขีดล่าง) และต้องไม่มีอักษรตัวพิมพ์ใหญ่

ชื่อนี้อาจถูกส่งผ่านเป็นพารามิเตอร์ที่ต้องการ () ดังนั้นจึงควรสั้นแต่ยังคงมีความหมาย

2.

ต้องระบุเวอร์ชัน หมายเลขเวอร์ชันของแพ็คเกจปัจจุบัน ค่าเริ่มต้นคือ 1.0.0 เมื่อสร้างขึ้นเป็นครั้งแรก

เวอร์ชันจะต้องแก้ไขได้โดยโมดูล node-semver ที่ npm ขึ้นอยู่กับ กำหนดความคืบหน้าในการวนซ้ำเวอร์ชันของโปรเจ็กต์ปัจจุบัน (ตามรูปแบบ "รุ่นหลัก รุ่นรอง รุ่นรอง")

บางทีเพื่อน ๆ หลายคนตอนนี้อาจไม่สนใจหรือไม่สนใจหมายเลขรุ่น และนิยมใช้หมายเลขรุ่นของผลิตภัณฑ์ หรือคอมไพล์ วิธีแฮชโค้ด

3.

ฟิลด์ตัวเลือกคำอธิบายต้องเป็นสตริง ข้อมูลคำอธิบายของแพ็คเกจปัจจุบันเป็นสตริง ช่วยให้ผู้คนค้นหาแพ็คเกจเมื่อใช้การค้นหา npm

หากไม่มีข้อมูล description ใน package.json, npm จะใช้บรรทัดแรกของ README.md ในโปรเจ็กต์เป็นข้อมูลคำอธิบาย ข้อมูลคำอธิบายนี้จะช่วยให้ผู้อื่นค้นหาโครงการของคุณได้ ดังนั้นจึงแนะนำให้เขียนข้อมูล description ให้ดี

4.

ฟิลด์ตัวเลือกหลักระบุไฟล์รายการสำหรับการโหลดโปรเจ็กต์

ค่าเริ่มต้นของฟิลด์นี้คือ index.js ใต้ไดเร็กทอรีรากของโมดูล

5. ฟิลด์ตัวเลือกสคริปต์

scripts เป็นวัตถุแฮชที่ประกอบด้วยคำสั่งสคริปต์ สคริปต์เหล่านี้ถูกดำเนินการในวงจรชีวิตที่แตกต่างกันของแพ็คเกจ คีย์คือเหตุการณ์วงจรชีวิต และค่าคือคำสั่งที่จะรัน ระบุตัวย่อบรรทัดคำสั่ง npm สำหรับการรันคำสั่งสคริปต์ ตัวอย่างเช่น start ระบุคำสั่งที่จะถูกดำเนินการเมื่อรัน npm run start เราสามารถปรับแต่งคำสั่งที่เราต้องการเรียกใช้สคริปต์ได้

อ้างอิง: http://www.ruanyifeng.com/blog/2016/10/npm_scripts.html

สคริปต์การดำเนินการกำหนดค่าสคริปต์

• 1) ดำเนินการคำสั่ง echo xxx

• 2. เพื่อดำเนินการไฟล์ภายใต้ node_modules/.bin

เหตุใดจึงสามารถดำเนินการได้

เมื่อฉันรันการรัน npm เชลล์ใหม่จะถูกสร้างขึ้นโดยอัตโนมัติ และคำสั่งสคริปต์ที่ระบุจะถูกดำเนินการในเชลล์นี้ ดังนั้นตราบใดที่คำสั่งสามารถรันโดย Shell (โดยปกติคือ Bash) ก็สามารถเขียนเป็นสคริปต์ npm ได้ จะคัดลอก node_modules/.bin ในไดเร็กทอรีปัจจุบันไปยังพาธของระบบปัจจุบันด้วย (เป็นเพียงการคัดลอกชั่วคราว หลังจากดำเนินการเสร็จสิ้น ตัวแปร PATH จะถูกกู้คืนสู่สถานะดั้งเดิม) ดังนั้นสคริปต์ทั้งหมดใน node_modules /.bin ไดเร็กทอรีย่อยของไดเร็กทอรีปัจจุบัน ทั้งหมดสามารถเรียกได้โดยตรงโดยใช้ชื่อสคริปต์โดยไม่ต้องเพิ่มเส้นทาง

ตัวอย่างเช่น:

หากเราใช้โหนดเพื่อดำเนินการบริการ node.js node + 文件สามารถใช้ node server.js เรายังสามารถใช้ webpack เพื่อจัดทำแพ็คเกจไฟล์ส่วนหน้า webpack-dev-server แน่นอน webpack และ จำเป็นต้องติดตั้งโมดูลที่ต้องพึ่งพา webpack-dev-server

: {   
    "build": "webpack --mode=การพัฒนา",
    "dev": "webpack-dev-server --mode=development --contentBase=./dist",
    "เซิร์ฟเวอร์": "โหนด app.js"
  }

เราป้อน npm run server ในเครื่องมือบรรทัดคำสั่ง และจะมีการเรียกโหนด app.js เพื่อช่วยเรารัน

แบบสั้น:

npm start คือ npm run start
npm stop เป็นตัวย่อของ npm run stop การทดสอบ npm เป็นตัวย่อของ npm run test npm restart เป็นตัวย่อของ npm run stop && npm run restart && npm run start

สคริปต์ที่ใช้กันทั่วไป ----- การถ่ายโอนคอลเลกชันออนไลน์

// ลบไดเร็กทอรี "clean": "rimraf dist/*",

// สร้างบริการ HTTP "ให้บริการ" ในเครื่อง: "http-server -p 9090 dist/",

//เปิดเบราว์เซอร์ "open:dev": "opener http://localhost:9090",

//รีเฟรช "livereload" แบบเรียลไทม์: "live-reload --port 9091 dist/",

// สร้างไฟล์ HTML "build:html": "jade index.jade > dist/index.html",

// ตราบใดที่ไฟล์ CSS เปลี่ยนแปลง ให้รัน build "watch:css" อีกครั้ง: "watch 'npm run build:css' Assets/styles/",

// ตราบใดที่ไฟล์ HTML เปลี่ยนแปลง ให้รัน build "watch:html" อีกครั้ง: "watch 'npm run build:html' Assets/html",

//ปรับใช้กับ Amazon S3
"deploy:prod": "s3-cli sync ./dist/ s3://example-com/prod-site/",

//สร้าง favicon
"build:favicon": "โหนดสคริปต์/favicon.js",

"start": "cross-env NODE_ENV=production node server/index.js",

6. การขึ้นต่อกันและ devDependencies

เป็นฟิลด์ทางเลือก ฟิลด์ dependencies ต่อกันระบุโมดูลที่โปรเจ็กต์ขึ้นอยู่กับ และ devDependencies ระบุโมดูลที่จำเป็นสำหรับการพัฒนาโปรเจ็กต์

ค่าชี้ไปที่วัตถุ สมาชิกแต่ละคนของออบเจ็กต์นี้ประกอบด้วยชื่อโมดูลและข้อกำหนดเวอร์ชันที่เกี่ยวข้อง ซึ่งระบุโมดูลที่ต้องพึ่งพาและช่วงเวอร์ชัน

ไม่มีการสร้าง package.json ตามค่าเริ่มต้น มันจะถูกสร้างขึ้นเมื่อเราติดตั้ง npm install โมดูล

npm ติดตั้งด่วน
npm ติดตั้งด่วน -- บันทึก
npm install express --save-dev

โค้ดด้านบนหมายถึงการติดตั้งโมดูล express แยกต่างหาก

• เมื่อไม่มีพารามิเตอร์อยู่ด้านหลัง หมายถึงการติดตั้งลงในแอตทริบิวต์ dependencies
คุณลักษณะ
• --save-dev หมายถึงการเขียนโมดูล
• --save แอตทริบิวต์ dependencies
devDependencies

7.

ฟิลด์เสริมแบบบันเดิลการพึ่งพา การอ้างอิงอื่นๆ ที่จัดทำแพ็กเกจพร้อมกันเมื่อเผยแพร่แพ็กเกจ

8.

ฟิลด์เสริม peerDependencies การพึ่งพาความเข้ากันได้ หากโปรเจ็กต์หรือโมดูลของคุณขึ้นอยู่กับโมดูลอื่นในเวลาเดียวกัน แต่เวอร์ชันที่ขึ้นอยู่กับนั้นแตกต่างกัน

ตัวอย่างเช่น โครงการของคุณขึ้นอยู่กับเวอร์ชัน 1.0 ของโมดูล A และโมดูล B และโมดูล A เองก็ขึ้นอยู่กับเวอร์ชัน 2.0 ของโมดูล B

-
  "ชื่อ": "ชัยตามสัญญา",
  "เพียร์พึ่งพา": {
    "ชัย": "1.x"
  -
}

โค้ดข้างต้นระบุว่าเมื่อติดตั้งโมดูล chai-as-promised โปรแกรมหลัก chai จะต้องติดตั้งพร้อมกัน และเวอร์ชัน chai ต้องเป็น 1.x หากการขึ้นต่อกันที่ระบุโดยโปรเจ็กต์ของคุณคือเวอร์ชัน 2.0 ของ chai ข้อผิดพลาดจะถูกรายงาน

9.

ฟิลด์ตัวเลือก Bin ฟิลด์ bin ใช้เพื่อระบุตำแหน่งของไฟล์ปฏิบัติการที่สอดคล้องกับแต่ละคำสั่งภายใน

สร้างไฟล์ /bin/www ในไดเร็กทอรีรากของโปรเจ็กต์

กำหนดค่า

"bin"

โหนด /usr/bin/env

  "lee-cli": "./bin/www"
}

npm link เพิ่มพาธค่าของแอตทริบิวต์ bin ในแพ็คเกจไปยังลิงก์โกลบอล สร้างการเชื่อมต่อทางลัด และ

ดำเนินการ lee-cli บนบรรทัดคำสั่งเพื่อเรียกใช้งานไฟล์ bin/www กระบวนการคือ:

ในตัวอย่างข้างต้น www จะสร้างลิงก์สัญลักษณ์ node_modules/.bin/www เนื่องจากไดเร็กทอรี node_modules/.bin/ จะถูกเพิ่มลงในตัวแปร PATH ของระบบขณะรันไทม์ จึงสามารถเรียกสคริปต์เหล่านี้ได้โดยตรงผ่านคำสั่งโดยไม่มีพาธเมื่อรัน npm

10. config

ฟิลด์ config ใช้เพื่อส่งออกค่าไปยังตัวแปรสภาพแวดล้อม

{
  "ชื่อ" : "แพ็คเกจ",
  "config" : { "พอร์ต" : "8080" },
  "scripts" : { "start" : "node server.js" }
}

หากเราต้องการเปลี่ยน เราสามารถใช้

npm config set package:port 80

11

ฟิลด์ตัวเลือกของเอ็นจิ้นจะระบุเวอร์ชันแพลตฟอร์มที่โมดูลทำงาน เช่น เวอร์ชันหนึ่งของโหนดหรือเบราว์เซอร์ คุณยังสามารถระบุได้ เวอร์ชัน npm ที่ใช้งานได้

"เครื่องยนต์" : { 
"โหนด" : 
">=0.10.3 <0.12"
}

12.

ช่องตัวเลือกใบอนุญาต ซึ่งระบุคำจำกัดความของใบอนุญาตที่ใช้กับโค้ดที่อธิบายไว้ใน package.json โปรโตคอลที่แตกต่างกันมีข้อจำกัดที่แตกต่างกัน แจ้งให้ผู้ใช้ทราบว่าพวกเขามีสิทธิ์ใดบ้างในการใช้โมดูลของคุณ และมีข้อจำกัดอะไรบ้างในการใช้งาน

โปรดดูที่: choosealicense.com/ เพื่อเลือกใบอนุญาต

ตัวอย่างเช่น: MIT: การอนุญาตสูงสุด ผู้อื่นสามารถเปลี่ยนรหัสของคุณหลังจากดาวน์โหลดได้ ค่าเริ่มต้นของการติดตั้ง

13. ผู้เขียน

ฟิลด์เสริม, ผู้พัฒนาโครงการ

14.

ฟิลด์ตัวเลือกส่วนตัว ค่าบูลีน ไม่ว่าจะเป็นส่วนตัว เมื่อตั้งค่าเป็นจริง npm จะปฏิเสธที่จะเผยแพร่

นี่เป็นวิธีป้องกันไม่ให้แพ็คเกจส่วนตัวถูกเผยแพร่สู่บุคคลภายนอก หากคุณต้องการรวมแพ็กเกจที่จะเผยแพร่เฉพาะกับรีจิสทรีเฉพาะ (เช่น รีจิสทรีภายใน) คุณสามารถใช้คำอธิบายพจนานุกรม publishConfig ด้านล่างเพื่อแทนที่พารามิเตอร์การกำหนดค่ารีจิสทรีในเวลาเผยแพร่

15.

ฟิลด์ตัวเลือกคำหลัก คำสำคัญของโครงการ เป็นอาร์เรย์สตริง ช่วยให้ผู้คนค้นหาแพ็คเกจเมื่อใช้การค้นหา npm

16. ฟิลด์ตัวเลือกระบบ

ปฏิบัติการระบุระบบปฏิบัติการที่โมดูลสามารถทำงานได้

17. สไตล์สไตล์

ระบุตำแหน่งของไฟล์สไตล์เมื่อใช้โดยเบราว์เซอร์

18.

ประเภทของตำแหน่งที่เก็บโค้ดแพ็คเกจพื้นที่เก็บข้อมูลอาจเป็น git หรือ svn ได้

19. ช่องตัวเลือกของหน้าแรก

ไม่มี URL ที่มีส่วนนำหน้าโปรโตคอล เช่น http://

ปัญหาเวอร์ชัน:

เวอร์ชัน: "1.0.0"

1.0.0:

การเปลี่ยนแปลงหลักแรกหมายถึง: ความเข้ากันไม่ได้กับโค้ดเก่า, การอัปเดตขนาดใหญ่, การเปิดตัวเวอร์ชันใหม่;

ตัวเลขหลักที่สองหมายถึง: มีการเพิ่มฟังก์ชันบางอย่าง, ความเข้ากันได้แบบย้อน

หลัง

;

หมายถึง: มีการเพิ่มฟังก์ชันบางอย่าง, บิตความเข้ากันได้แบบย้อนหลัง

หมายถึง: แพตช์ขนาดเล็ก, การแก้ไขข้อบกพร่อง;

เมื่อเราเผยแพร่โปรเจ็กต์ เราใช้ npm + git

• เพื่อใช้ npm version patch (แพตช์แพตช์) ; ใช้ git tag เพื่อดำเนินการและมันจะอยู่ใน git
• npm version minor เพื่อเปลี่ยนตัวเลขหลักที่สองของหมายเลขเวอร์ชัน ซิงโครไนซ์เวอร์ชัน git;
ใช้
• npm version major เพื่อเปลี่ยนตัวเลขตัวแรกของหมายเลขเวอร์ชัน ;

เวอร์ชัน npm [<newversion> | .premajor | .

major: หมายเลขเวอร์ชันหลัก minor: หมายเลขเวอร์ชันรอง patch: หมายเลขแพทช์ premajor: เวอร์ชันหลักเบื้องต้น prepatch: เวอร์ชันรองเบื้องต้น prerelease: เวอร์ชันก่อนเผยแพร่

ps: หมายเหตุ หากมีการรายงานข้อผิดพลาด: ไดเร็กทอรีการทำงานของ Git ไม่สะอาด หมายความว่าคุณ ต้องการ git status เพื่อให้สะอาดในตอนนี้

คอมไพล์เพิ่ม
git commit -m "package.json คำอธิบายโดยละเอียด"

npm versin monir -m"增加版本号"

git push -u origin master

จะกำหนดกฎได้อย่างไร?

ในฐานะผู้ใช้ เราสามารถระบุในไฟล์ package.json ว่าเราสามารถยอมรับการอัปเดตสำหรับแพ็คเกจนี้ได้มากเพียงใด (สมมติว่าปัจจุบันเราใช้เวอร์ชัน 1.2.4):

• หากเราตั้งใจที่จะยอมรับการอัปเดตสำหรับเวอร์ชันแพตช์เท่านั้น (นั่นคือ การเปลี่ยนแปลงหลักสุดท้าย ) คุณสามารถเขียนได้ดังนี้:

  1.2
   1.2.x
   ~1.2.4

• หากคุณยอมรับการอัปเดตเวอร์ชันรอง (การเปลี่ยนแปลงในตำแหน่งที่สอง) คุณสามารถเขียนดังนี้:

  1
  1.x
  ^1.2.4

• หากคุณสามารถยอมรับการอัปเดตเวอร์ชันหลักได้ (โดยธรรมชาติแล้วยอมรับการเปลี่ยนแปลงเวอร์ชันรองและเวอร์ชันแพตช์) คุณสามารถเขียนดังนี้:

  *x

  โดยสรุป: การเปลี่ยนแปลงเวอร์ชันมีสามประเภท ซึ่งประเภทของการอัปเดตของแพ็คเกจที่ต้องพึ่งพานั้นได้รับการยอมรับ ? เขียนหมายเลขเวอร์ชันให้ถูกต้องกับหลักก่อนหน้า

วงจรและขั้นตอนของเวอร์ชัน:

• α-Alpha โดยทั่วไประยะแรกมีไว้สำหรับการทดสอบภายในเท่านั้น
• β-Beta ระยะที่สองได้กำจัดข้อบกพร่องส่วนใหญ่ในซอฟต์แวร์แล้ว แต่อาจยังมีข้อบกพร่องและช่องโหว่อยู่ และโดยทั่วไปมีไว้เพื่อทดสอบโดยเฉพาะ และใช้ในกลุ่มผู้ใช้
• γ-RC เป็นขั้นตอนที่สาม ในขณะนี้ ผลิตภัณฑ์ค่อนข้างสมบูรณ์และจำเป็นต้องได้รับการปรับให้เหมาะสมเพิ่มเติมในบางสถานที่ก่อนจึงจะสามารถออกสู่ตลาดได้

ตัวอย่างเช่น

2.1.0-beta.1 โดยทั่วไปแล้วผู้ใช้ 2.1.0-beta.1 จะใช้สิ่งนี้ สิ่งนี้จะไม่ถูกติดตั้งโดยคนในและผู้ทดสอบ

ความแตกต่างระหว่างการติดตั้ง Dependencies และ dependencies ?

devDependencies เป็นโมดูลที่จำเป็นสำหรับการพัฒนา ดังนั้นเราจึงสามารถติดตั้งได้ตามความจำเป็นในระหว่างกระบวนการพัฒนาเพื่อปรับปรุงประสิทธิภาพการพัฒนาของเรา เช่น ไลบรารีบุคคลที่สามที่มีชื่อเสียง, webpack , rollUp , less , babel เป็นต้น ไม่จำเป็นต้องติดตั้งในสภาพแวดล้อมการใช้งานจริง

แนะนำให้ติดตั้งไลบรารีต่อไปนี้ใน devDependencies :

• รองรับการทดสอบหน่วย (mocha, chai);
• ความเข้ากันได้ของไวยากรณ์ (babel);
• การแปลงไวยากรณ์ (jsx เป็น js, ​​coffeescript เป็น js, ​​typescript เป็น js)
• การสร้างโปรแกรมและการเพิ่มประสิทธิภาพ (
webpack,
• gulp
• , grunt, uglifyJS)
• ;

1. ติดตั้งแพ็คเกจการพึ่งพาในเครื่อง

npm

ติดตั้ง jquery

คำสั่งนี้จะ สร้าง a ในไดเร็กทอรีปัจจุบัน node_modules จากนั้นดาวน์โหลดแพ็คเกจที่เราระบุลงในไดเร็กทอรีนี้

2. หากต้องการระบุเวอร์ชันการติดตั้ง คุณสามารถ @版本号หลังชื่อแพ็กเกจได้

หากชื่อของแพ็คเกจขึ้นต้นด้วย package @ แสดงว่ามันคือ แพ็คเกจที่กำหนดขอบเขต

npm ติดตั้ง [email protected]
npm ติดตั้ง jquery@">=1.1.0 <2.2.0"

npm install jquery@latest

หมายเลขเวอร์ชันในการขึ้นต่อกันก็จะเปลี่ยนไปเช่นกัน

3. อัปเดตแพ็คเกจที่ต้องพึ่งพา

npm update jquery

4. ใช้แพ็คเกจ

ให้ jquery = need('jquery');

<script src="/node_modules/jquery/dist/jquery.js">//สิ่งนี้จำเป็นต้องใส่ใจกับ เส้นทาง</script>

6 , ถอนการติดตั้งแพ็คเกจที่ต้องพึ่งพา

npm ถอนการติดตั้ง jquery

การกำหนดเวอร์ชันแบบ Semantic (กฎการกำหนดเวอร์ชันแบบความหมาย)

• https://docs.npmjs.com/about-semantic-versioning

• https://github.com/npm/node-semver

package .json หมายเหตุ

package.json ข้างต้น เมื่อเราใช้ npm init name จะถูกขอให้กรอกหลายรายการ version . หากไม่เป็นเช่นนั้น จะไม่สามารถดำเนิน install ได้

• ชื่อ: ตัวพิมพ์เล็กทั้งหมด, ไม่มีการเว้นวรรค, ใช้เครื่องหมายยัติภังค์และขีดล่างตามลำดับ
• เวอร์ชัน: หมายเลขเวอร์ชัน, ปฏิบัติตามกฎการกำหนดเวอร์ชันความหมายที่กล่าวถึงข้างต้น xxx

หมายเหตุอื่น ๆ:

• การเพิ่มความคิดเห็นภาษาจีนจะทำให้เกิดข้อผิดพลาดในการคอมไพล์