volta pin

คำสั่ง volta pin จะอัปเดตไฟล์ package.json ของโปรเจกต์เพื่อใช้เวอร์ชันเครื่องมือที่เลือก มีไวยากรณ์ดังนี้:

ปักหมุด runtime หรือ package manager ของโปรเจกต์คุณ

USAGE:
    volta pin [FLAGS] <tool[@version]>...

FLAGS:
        --verbose    เปิดใช้งานการวินิจฉัยอย่างละเอียด
        --quiet      ป้องกันเอาต์พุตที่ไม่จำเป็น
    -h, --help       แสดงข้อมูลวิธีใช้

ARGS:
    <tool[@version]>...    เครื่องมือที่จะปักหมุด เช่น `node@lts` หรือ `yarn@^1.14`

หมายเหตุvolta pin ทำงานได้เฉพาะกับ Node และ Package Managers (เช่น npm หรือ Yarn) สำหรับ dependencies คุณควรใช้ npm install หรือ yarn add เพื่ออัปเดตเวอร์ชันที่เลือก

ตัวอย่าง

การปักหมุด Node.js

# ปักหมุดเวอร์ชัน LTS ล่าสุดของ Node
volta pin node

# ปักหมุดเวอร์ชัน Node เฉพาะ
volta pin node@16.14.2

# ปักหมุดช่วงเวอร์ชัน Node
volta pin node@16

เมื่อคุณปักหมุดเวอร์ชัน Node.js Volta จะเพิ่มส่วน volta ไปยังไฟล์ package.json ของโปรเจกต์คุณ:

{
  "volta": {
    "node": "16.14.2"
  }
}

การปักหมุด Package Managers

# ปักหมุดเวอร์ชัน npm ล่าสุด
volta pin npm

# ปักหมุดเวอร์ชัน Yarn เฉพาะ
volta pin yarn@1.22.19

# ปักหมุด pnpm (หากเปิดใช้งาน feature flag)
VOLTA_FEATURE_PNPM=1 volta pin pnpm@7.0.0

การปักหมุด package managers จะเพิ่มพวกมันไปยังส่วน volta ใน package.json ของคุณ:

{
  "volta": {
    "node": "16.14.2",
    "npm": "8.5.0"
  }
}

กรณีการใช้งาน

คำสั่ง volta pin มีความสำคัญสำหรับ:

• สร้างสภาพแวดล้อมการพัฒนาที่สอดคล้องกันทั่วทั้งทีมของคุณ
• ตรวจสอบให้แน่ใจว่าทุกคนที่ทำงานบนโปรเจกต์ใช้เวอร์ชัน Node.js และ package manager เดียวกัน
• ป้องกันปัญหา "works on my machine"
• เอกสารว่าโปรเจกต์ของคุณเข้ากันได้กับเวอร์ชัน Node.js ใด

ผลกระทบของการปักหมุด

เมื่อคุณปักหมุดเครื่องมือ:

1. เครื่องมือจะถูกติดตั้งโดยอัตโนมัติหากคุณยังไม่มี
2. เวอร์ชันจะถูกเขียนไปยัง package.json ในส่วน volta
3. ทุกคนที่มี Volta ที่ทำงานบนโปรเจกต์จะใช้เวอร์ชันที่ระบุโดยอัตโนมัติ
4. ระบบ CI/CD ที่ใช้ Volta จะใช้เวอร์ชันที่ถูกต้อง

เครื่องมือที่ปักหมุดมีลำดับความสำคัญเหนือกว่าเวอร์ชันเครื่องมือเริ่มต้นที่ตั้งค่าด้วย volta install

รายละเอียด Package.json

ส่วน volta ใน package.json สามารถรวม:

{
  "volta": {
    "node": "16.14.2",    // เวอร์ชันแน่นอน
    "npm": "^8.5.0",      // ช่วง Semver
    "yarn": "1.22.19",    // เวอร์ชันแน่นอน
    "pnpm": "7.0.0"       // หากเปิดใช้งานการสนับสนุน pnpm
  }
}

ตัวระบุเวอร์ชันสามารถเป็น:

• เวอร์ชันแน่นอน: 16.14.2
• เวอร์ชันหลัก: 16
• เวอร์ชันหลัก.รอง: 16.14
• ช่วง Semver: ^16.14.0
• แท็ก: lts, latest