終極指南：使用 GitHub API 建立完整的問題追蹤器-js教程-PHP中文網

Ultimate Guide: Build a Complete Issue Tracker with the GitHub API

本指南將幫助您建立一個與 GitHub API 整合的自動化、高效的問題追蹤器。您將逐步學習如何設定問題建立、分配、通知等！

1. 第 1 步：取得您的 GitHub 個人存取權杖 (PAT)

要存取私人儲存庫或避免速率限制，您需要一個個人存取權杖（PAT）。

如何產生令牌：

前往設定>開發者設定>您的 GitHub 帳戶中的個人存取權令牌。
點選產生新令牌。
選擇權限，例如 repo（用於儲存庫存取）。
保存令牌 - 您將需要它來在程式碼中授權。

2. 第 2 步：建立基本問題追蹤器

此程式碼可讓您透過 GitHub API 在任何儲存庫中建立問題。

async function createIssue(owner, repo, title, body, token) {
  const url = `https://api.github.com/repos/${owner}/${repo}/issues`;
  const response = await fetch(url, {
    method: 'POST',
    headers: {
      Authorization: `token ${token}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ title, body }),
  });

  const issue = await response.json();
  console.log(`Issue Created: ${issue.html_url}`);
}

createIssue('YourGitHubUsername', 'my-repo', 'Bug Report', 'Details about the bug.', 'your_token');

登入後複製

？ 工作原理：

將「YourGitHubUsername」和「my-repo」替換為您的使用者名稱和儲存庫名稱。
此函數將新問題發佈到儲存庫。
檢查控制台日誌中的問題連結。

3. 第 3 步：自動分配問題

確保每個問題都會自動分配給團隊成員。此步驟可以節省時間，確保問責制。

async function assignIssue(owner, repo, issueNumber, assignees, token) {
  const url = `https://api.github.com/repos/${owner}/${repo}/issues/${issueNumber}`;
  const response = await fetch(url, {
    method: 'PATCH',
    headers: {
      Authorization: `token ${token}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ assignees }),
  });

  const updatedIssue = await response.json();
  console.log(`Issue Assigned: ${updatedIssue.html_url}`);
}

assignIssue('YourGitHubUsername', 'my-repo', 42, ['assignee_username'], 'your_token');

登入後複製

？ 它的作用：

建立問題後使用此功能將其指派給團隊成員。
將 42 替換為您要指派的問題編號。

4. 第 4 步：取得未決問題以進行更好的管理

追蹤所有未解決的問題對於有效管理專案至關重要。使用此程式碼列出所有未解決的問題。

async function getOpenIssues(owner, repo, token) {
  const url = `https://api.github.com/repos/${owner}/${repo}/issues?state=open`;
  const response = await fetch(url, {
    headers: { Authorization: `token ${token}` },
  });

  const issues = await response.json();
  console.log(`Total Open Issues: ${issues.length}`);
  issues.forEach(issue => console.log(`#${issue.number}: ${issue.title}`));
}

getOpenIssues('YourGitHubUsername', 'my-repo', 'your_token');

登入後複製

？ 有什麼幫助：

取得儲存庫中的所有未決問題。
您可以在儀表板中顯示它們或向開發人員發送通知。

5. 第 5 步：監控過時問題並發送警報

針對長時間未解決的問題建立警報。設定 cron 作業 定期（例如每天）執行此程式碼並透過 Slack 或電子郵件發送通知。

async function checkStaleIssues(owner, repo, daysOld, token) {
  const url = `https://api.github.com/repos/${owner}/${repo}/issues?state=open`;
  const response = await fetch(url, {
    headers: { Authorization: `token ${token}` },
  });

  const issues = await response.json();
  const today = new Date();

  issues.forEach(issue => {
    const createdDate = new Date(issue.created_at);
    const ageInDays = (today - createdDate) / (1000 * 60 * 60 * 24);

    if (ageInDays > daysOld) {
      console.log(`Stale Issue: #${issue.number} - ${issue.title}`);
      // Send alert logic here (e.g., Slack or email notification)
    }
  });
}

checkStaleIssues('YourGitHubUsername', 'my-repo', 7, 'your_token');

登入後複製

？ 它的作用：

辨識早於指定天數的陳舊問題。
將此功能與 Slack、Discord 或電子郵件警報結合使用，以通知團隊成員。

6. 第 6 步：根據關鍵字自動發布問題標籤

使用簡單的關鍵字來配對根據內容自動標記問題。這可以幫助立即對問題進行分類。

async function createIssue(owner, repo, title, body, token) {
  const url = `https://api.github.com/repos/${owner}/${repo}/issues`;
  const response = await fetch(url, {
    method: 'POST',
    headers: {
      Authorization: `token ${token}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ title, body }),
  });

  const issue = await response.json();
  console.log(`Issue Created: ${issue.html_url}`);
}

createIssue('YourGitHubUsername', 'my-repo', 'Bug Report', 'Details about the bug.', 'your_token');

登入後複製

？ 用法：

自動為相關問題加上標籤，例如「錯誤」或「功能請求」。
將其與文字分析結合，以偵測問題標題或描述中的關鍵字（例如「錯誤」、「請求」）。

7. 第 7 步：建立儀表板來顯示問題

使用 JavaScript 和 GitHub API 建立一個儀表板，以在網頁上顯示所有未解決的問題。您可以視覺化問題狀態、分配和標籤。

async function assignIssue(owner, repo, issueNumber, assignees, token) {
  const url = `https://api.github.com/repos/${owner}/${repo}/issues/${issueNumber}`;
  const response = await fetch(url, {
    method: 'PATCH',
    headers: {
      Authorization: `token ${token}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ assignees }),
  });

  const updatedIssue = await response.json();
  console.log(`Issue Assigned: ${updatedIssue.html_url}`);
}

assignIssue('YourGitHubUsername', 'my-repo', 42, ['assignee_username'], 'your_token');

登入後複製

？ 這是如何運作的：