用 Claude Code 搞构建
故障排查
常见问题和解决办法，卡壳了先来这里看看。
页面信息
这页不是官方原文，而是顺着官方文档结构做的中文解释版。命令、参数、配置名这些硬东西尽量保留，解释部分则尽量讲成人能照着做的话。
如果你碰到特别敏感的配置、权限或企业环境差异，最好顺手点上面的“查看原始文档”再核一遍。
这一页先讲明白
这一页是遇到问题时的急救箱。
当安装失败、登录不通、命令跑不动、结果不对时，先来这里排查。
排错最怕瞎撞墙。官方这页的价值就是帮你先分门别类：到底是环境问题、权限问题、网络问题，还是命令本身没写清。
先分清类别，修起来才快。
每次排错都先记下报错原文、运行环境和你刚刚做了什么。
不要一上来全盘重装。先查最小可验证项，比如版本、登录状态、网络连通、目录是否正确。
照着做一遍
这页属于“故障排查”这类活，最稳的办法还是一小步一小步来。
下面这三步不一定华丽，但通常最不容易绕晕。
第 1 步：先起步
每次排错都先记下报错原文、运行环境和你刚刚做了什么。
第 2 步：边做边看
不要一上来全盘重装。先查最小可验证项，比如版本、登录状态、网络连通、目录是否正确。
一眼看懂这一页
这页的作用，就是把原本偏专业的话题，拆成能直接照着走的明白话。
故障排查
|
v
常见问题和解决办法，卡壳了先来这里看看。
|
v
照着步骤去做文末提醒
这站会按官方 docs 的导航和内容变化继续重生成，原站加页、删页、改页时，这里会跟着更新。
人话解释会尽量顺着原页往下讲，但命令、参数名、配置名这些硬东西还是保留原样，免得你抄过去跑不起来。