{
  "id": "git/warning-large-filesystem-time-skew",
  "signature": "warning: clock skew detected. Your build may be incomplete.",
  "signature_zh": "警告：检测到时钟偏差。您的构建可能不完整。",
  "regex": "warning: clock skew detected\\. Your build may be incomplete\\.",
  "domain": "git",
  "category": "runtime_error",
  "subcategory": null,
  "root_cause": "The system clock on the machine running git is significantly ahead or behind the timestamps of files in the working tree, causing git to misjudge file modification times and potentially skip rebuilds or produce stale outputs.",
  "root_cause_type": "generic",
  "root_cause_zh": "运行 git 的机器系统时钟与工作树中文件的时间戳存在显著差异，导致 git 误判文件修改时间，可能跳过重建或产生过时的输出。",
  "versions": [
    {
      "version": "git 2.20.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "git 2.38.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "git 2.45.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "",
      "why_fails": "Running git clean -fd to remove untracked files does not fix the clock skew issue; it only deletes files without addressing the root cause.",
      "fail_rate": 0.95,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "Manually touching all files with touch * can temporarily mask the issue but the skew will reappear on subsequent operations if clock is not fixed.",
      "fail_rate": 0.7,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "sudo ntpdate -s time.nist.gov  # Sync system clock with an NTP server to eliminate the skew",
      "success_rate": 0.9,
      "how": "sudo ntpdate -s time.nist.gov  # Sync system clock with an NTP server to eliminate the skew",
      "condition": "",
      "sources": []
    },
    {
      "action": "git add -A && git commit --allow-empty -m 'reset timestamps'  # Force a commit to reset internal timestamps, but this is a temporary fix",
      "success_rate": 0.6,
      "how": "git add -A && git commit --allow-empty -m 'reset timestamps'  # Force a commit to reset internal timestamps, but this is a temporary fix",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "sudo ntpdate -s time.nist.gov  # Sync system clock with an NTP server to eliminate the skew",
    "git add -A && git commit --allow-empty -m 'reset timestamps'  # Force a commit to reset internal timestamps, but this is a temporary fix"
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://git-scm.com/docs/git#_configuration",
  "official_doc_section": null,
  "error_code": null,
  "verification_tier": "ai_generated",
  "confidence": 0.85,
  "fix_success_rate": 0.9,
  "resolvable": "true",
  "first_seen": "2023-09-10",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}