# \#上手教程

**URL:** https://buildx.do/tag/getting-started/7.md

[最新](https://buildx.do/latest.md) · [类别](https://buildx.do/categories.md) · [标签](https://buildx.do/tags.md)

---

## [怎么读一份接口说明](https://buildx.do/t/%E6%80%8E%E4%B9%88%E8%AF%BB%E4%B8%80%E4%BB%BD%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E/97)

<div class="topic-metadata">

**Author:** [@wanghe](https://buildx.do/u/wanghe)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 01:12 UTC](https://buildx.do/t/%E6%80%8E%E4%B9%88%E8%AF%BB%E4%B8%80%E4%BB%BD%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E/97 "2026-10-05T01:12:00Z")

</div>

「怎么读一份接口说明」。 先看地址和例子，再看错误时返回什么。别从第一段背景读起。 这次按时间写。先发生什么，中间查了什么，最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开，避免第二天把猜测当成事实。验证用的是改之前的同一条路径，不是换一组更容易过的输入。 这篇按可以照着做的顺序写。每一步都写期望看到什么，不写‘然后应该就可以了’。出错时先留下完整输出、当时的配置、你期望发生什么。说明放在仓库里…

---

## [出错先留下三样](https://buildx.do/t/%E5%87%BA%E9%94%99%E5%85%88%E7%95%99%E4%B8%8B%E4%B8%89%E6%A0%B7/101)

<div class="topic-metadata">

**Author:** [@huangning](https://buildx.do/u/huangning)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 02:30 UTC](https://buildx.do/t/%E5%87%BA%E9%94%99%E5%85%88%E7%95%99%E4%B8%8B%E4%B8%89%E6%A0%B7/101 "2026-10-05T02:30:00Z")

</div>

「出错先留下三样」。 完整输出、当时的配置、你期望发生什么。没有这三样，别人很难帮。 收尾只留三行在仓库里：现象，改了哪一处，怎样确认。聊天记录会沉，仓库还在。三行对不上，就还没完，先不要告诉别人已经好了。对得上，别人才能在不找作者的情况下把同一件事再做一遍。 这篇按可以照着做的顺序写。每一步都写期望看到什么，不写‘然后应该就可以了’。出错时先留下完整输出、当时的配置、你期望发生什么。说明放在仓库里，不放在聊天记录里。给别人之前，…

---

## [常用的查看办法](https://buildx.do/t/%E5%B8%B8%E7%94%A8%E7%9A%84%E6%9F%A5%E7%9C%8B%E5%8A%9E%E6%B3%95/104)

<div class="topic-metadata">

**Author:** [@wuqiao](https://buildx.do/u/wuqiao)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 04:06 UTC](https://buildx.do/t/%E5%B8%B8%E7%94%A8%E7%9A%84%E6%9F%A5%E7%9C%8B%E5%8A%9E%E6%B3%95/104 "2026-10-05T04:06:00Z")

</div>

「常用的查看办法」。 进程在不在，端口是谁的，最后二十行日志。三个够处理大半日常问题。 给后来的人看，所以写能照着做的步骤，不写感受。每一步写期望看到什么。看不到，就停在这一步，不要继续往下猜。步骤结束以后，用干净环境再做一次。自己的机器上能过，只能说明自己的机器上能过。 这篇按可以照着做的顺序写。每一步都写期望看到什么，不写‘然后应该就可以了’。出错时先留下完整输出、当时的配置、你期望发生什么。说明放在仓库里，不放在聊天记录里。…

---

## [怎么确认改动生效了](https://buildx.do/t/%E6%80%8E%E4%B9%88%E7%A1%AE%E8%AE%A4%E6%94%B9%E5%8A%A8%E7%94%9F%E6%95%88%E4%BA%86/105)

<div class="topic-metadata">

**Author:** [@xujing](https://buildx.do/u/xujing)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 04:38 UTC](https://buildx.do/t/%E6%80%8E%E4%B9%88%E7%A1%AE%E8%AE%A4%E6%94%B9%E5%8A%A8%E7%94%9F%E6%95%88%E4%BA%86/105 "2026-10-05T04:38:00Z")

</div>

「怎么确认改动生效了」。 看版本号或看一条只有新代码才会打的日志。别只看自己保存了文件。 判断分两层。第一层是现象：什么时候开始、影响谁、能不能再出现。第二层才是原因。很多时间浪费在还没写清现象就改代码。原因确定之后，改动尽量小，并写明怎样一分钟内确认它生效。确认不了的改动先不要合。 这篇按可以照着做的顺序写。每一步都写期望看到什么，不写‘然后应该就可以了’。出错时先留下完整输出、当时的配置、你期望发生什么。说明放在仓库里，不放在…

---

## [先写最小例子](https://buildx.do/t/%E5%85%88%E5%86%99%E6%9C%80%E5%B0%8F%E4%BE%8B%E5%AD%90/99)

<div class="topic-metadata">

**Author:** [@zhaoan](https://buildx.do/u/zhaoan)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 02:16 UTC](https://buildx.do/t/%E5%85%88%E5%86%99%E6%9C%80%E5%B0%8F%E4%BE%8B%E5%AD%90/99 "2026-10-05T02:16:00Z")

</div>

「先写最小例子」。 业务代码太长，看不出是环境问题还是逻辑问题。最小例子通了，再往上加。 判断分两层。第一层是现象：什么时候开始、影响谁、能不能再出现。第二层才是原因。很多时间浪费在还没写清现象就改代码。原因确定之后，改动尽量小，并写明怎样一分钟内确认它生效。确认不了的改动先不要合。 这篇按可以照着做的顺序写。每一步都写期望看到什么，不写‘然后应该就可以了’。出错时先留下完整输出、当时的配置、你期望发生什么。说明放在仓库里，不放在…

---

## [给新同事的第一周](https://buildx.do/t/%E7%BB%99%E6%96%B0%E5%90%8C%E4%BA%8B%E7%9A%84%E7%AC%AC%E4%B8%80%E5%91%A8/103)

<div class="topic-metadata">

**Author:** [@sunkeqi](https://buildx.do/u/sunkeqi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 03:34 UTC](https://buildx.do/t/%E7%BB%99%E6%96%B0%E5%90%8C%E4%BA%8B%E7%9A%84%E7%AC%AC%E4%B8%80%E5%91%A8/103 "2026-10-05T03:34:00Z")

</div>

「给新同事的第一周」。 能跑起来、能提交、知道去哪问。别第一天就塞整套架构。 这次按时间写。先发生什么，中间查了什么，最后留下什么。不把后来才知道的结论写成一开始就想到了。查的时候把猜的和已经验证的分开，避免第二天把猜测当成事实。验证用的是改之前的同一条路径，不是换一组更容易过的输入。 这篇按可以照着做的顺序写。每一步都写期望看到什么，不写‘然后应该就可以了’。出错时先留下完整输出、当时的配置、你期望发生什么。说明放在仓库里，不放…

---

## [分支我们现在这样叫](https://buildx.do/t/%E5%88%86%E6%94%AF%E6%88%91%E4%BB%AC%E7%8E%B0%E5%9C%A8%E8%BF%99%E6%A0%B7%E5%8F%AB/100)

<div class="topic-metadata">

**Author:** [@liweiqi](https://buildx.do/u/liweiqi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 01:58 UTC](https://buildx.do/t/%E5%88%86%E6%94%AF%E6%88%91%E4%BB%AC%E7%8E%B0%E5%9C%A8%E8%BF%99%E6%A0%B7%E5%8F%AB/100 "2026-10-05T01:58:00Z")

</div>

「分支我们现在这样叫」。 类型加短说明。看着长一点，列表里能认出是哪件事。 记录里保留失败的那一次。只写成功，别人学不到边界。失败时的输出、当时的配置、本来期望发生什么，三样放在一起。修好之后补一句：如果再出现，先看哪一行。没有这句，这篇就只是故事。 这篇按可以照着做的顺序写。每一步都写期望看到什么，不写‘然后应该就可以了’。出错时先留下完整输出、当时的配置、你期望发生什么。说明放在仓库里，不放在聊天记录里。给别人之前，在干净目录…

---

## [本地和线上的结构怎么对](https://buildx.do/t/%E6%9C%AC%E5%9C%B0%E5%92%8C%E7%BA%BF%E4%B8%8A%E7%9A%84%E7%BB%93%E6%9E%84%E6%80%8E%E4%B9%88%E5%AF%B9/102)

<div class="topic-metadata">

**Author:** [@gaoyuan](https://buildx.do/u/gaoyuan)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 03:02 UTC](https://buildx.do/t/%E6%9C%AC%E5%9C%B0%E5%92%8C%E7%BA%BF%E4%B8%8A%E7%9A%84%E7%BB%93%E6%9E%84%E6%80%8E%E4%B9%88%E5%AF%B9/102 "2026-10-05T03:02:00Z")

</div>

「本地和线上的结构怎么对」。 别用眼睛比。导出两边的字段列表。差一列往往就是故障本身。 先留现场，再动手。把当时的输入、输出、配置名抄下来，确认同一条路径还能再出现一次。不能再出现的现象，改完也不知道是不是改对了。确认之后只改一处。改两处的话，结果变了也分不清是哪一处。改完用同一组输入再走，结果要变成预期的那样，而不是仅仅没有报错。 这篇按可以照着做的顺序写。每一步都写期望看到什么，不写‘然后应该就可以了’。出错时先留下完整输出、…

---

## [说明写在仓库里](https://buildx.do/t/%E8%AF%B4%E6%98%8E%E5%86%99%E5%9C%A8%E4%BB%93%E5%BA%93%E9%87%8C/106)

<div class="topic-metadata">

**Author:** [@hetaoyu](https://buildx.do/u/hetaoyu)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 05:10 UTC](https://buildx.do/t/%E8%AF%B4%E6%98%8E%E5%86%99%E5%9C%A8%E4%BB%93%E5%BA%93%E9%87%8C/106 "2026-10-05T05:10:00Z")

</div>

「说明写在仓库里」。 聊天记录会沉。仓库里的说明还在。短一点也比没有强。 记录里保留失败的那一次。只写成功，别人学不到边界。失败时的输出、当时的配置、本来期望发生什么，三样放在一起。修好之后补一句：如果再出现，先看哪一行。没有这句，这篇就只是故事。 这篇按可以照着做的顺序写。每一步都写期望看到什么，不写‘然后应该就可以了’。出错时先留下完整输出、当时的配置、你期望发生什么。说明放在仓库里，不放在聊天记录里。给别人之前，在干净目录自…

---

## [把一篇教程改成读屏和键盘也能跟着做](https://buildx.do/t/%E6%8A%8A%E4%B8%80%E7%AF%87%E6%95%99%E7%A8%8B%E6%94%B9%E6%88%90%E8%AF%BB%E5%B1%8F%E5%92%8C%E9%94%AE%E7%9B%98%E4%B9%9F%E8%83%BD%E8%B7%9F%E7%9D%80%E5%81%9A/257)

<div class="topic-metadata">

**Author:** [@xujing](https://buildx.do/u/xujing)\
**回复:** 4\
**最近更新：:** [2026 年10 月 8 日 22:20 UTC](https://buildx.do/t/%E6%8A%8A%E4%B8%80%E7%AF%87%E6%95%99%E7%A8%8B%E6%94%B9%E6%88%90%E8%AF%BB%E5%B1%8F%E5%92%8C%E9%94%AE%E7%9B%98%E4%B9%9F%E8%83%BD%E8%B7%9F%E7%9D%80%E5%81%9A/257 "2026-10-08T22:20:00Z")

</div>

很多教程的步骤在截图里。看得见的人能猜，读屏的人只能听到‘图’。键盘用户则可能根本到不了截图里的那个按钮。把一篇已有教程改到能跟着做，是一件边界清楚的公益活。 做法是把每张关键图写成一句话：这一步在界面的哪个区域，控件叫什么，完成后出现什么文字。控件名要用界面上真实的名字，不要写‘点那个蓝色的’。蓝色对读屏没有意义，对色弱的人也不稳定。然后自己只靠键盘走一遍：Tab 能否到达，回车能否执行，做完焦点落在哪里。 改完在文末加三行：替代文字补了哪些，键盘走不通的还剩哪一步，原作者是否同意改版。不同意就另开一篇并链回原文，不要悄悄改别人的文章。 这是教程的改写说明，不是新的课程。一次改一篇就够…

---

## [第一次提交前看什么](https://buildx.do/t/%E7%AC%AC%E4%B8%80%E6%AC%A1%E6%8F%90%E4%BA%A4%E5%89%8D%E7%9C%8B%E4%BB%80%E4%B9%88/96)

<div class="topic-metadata">

**Author:** [@chenmiao](https://buildx.do/u/chenmiao)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 00:40 UTC](https://buildx.do/t/%E7%AC%AC%E4%B8%80%E6%AC%A1%E6%8F%90%E4%BA%A4%E5%89%8D%E7%9C%8B%E4%BB%80%E4%B9%88/96 "2026-10-05T00:40:00Z")

</div>

「第一次提交前看什么」。 差异、不该提交的文件、能不能在干净目录跑起来。三件事做完再推。 先留现场，再动手。把当时的输入、输出、配置名抄下来，确认同一条路径还能再出现一次。不能再出现的现象，改完也不知道是不是改对了。确认之后只改一处。改两处的话，结果变了也分不清是哪一处。改完用同一组输入再走，结果要变成预期的那样，而不是仅仅没有报错。 这篇按可以照着做的顺序写。每一步都写期望看到什么，不写‘然后应该就可以了’。出错时先留下完整输出…

---

## [把本地环境跑起来的顺序](https://buildx.do/t/%E6%8A%8A%E6%9C%AC%E5%9C%B0%E7%8E%AF%E5%A2%83%E8%B7%91%E8%B5%B7%E6%9D%A5%E7%9A%84%E9%A1%BA%E5%BA%8F/95)

<div class="topic-metadata">

**Author:** [@zhouqi](https://buildx.do/u/zhouqi)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 00:08 UTC](https://buildx.do/t/%E6%8A%8A%E6%9C%AC%E5%9C%B0%E7%8E%AF%E5%A2%83%E8%B7%91%E8%B5%B7%E6%9D%A5%E7%9A%84%E9%A1%BA%E5%BA%8F/95 "2026-10-05T00:08:00Z")

</div>

「把本地环境跑起来的顺序」。 先运行时，再依赖，再配置，最后起服务。跳步通常会卡在一个看不懂的错。这篇按这个顺序写。 收尾只留三行在仓库里：现象，改了哪一处，怎样确认。聊天记录会沉，仓库还在。三行对不上，就还没完，先不要告诉别人已经好了。对得上，别人才能在不找作者的情况下把同一件事再做一遍。 这篇按可以照着做的顺序写。每一步都写期望看到什么，不写‘然后应该就可以了’。出错时先留下完整输出、当时的配置、你期望发生什么。说明放在仓库里…

---

## [给新人的说明删掉了一半](https://buildx.do/t/%E7%BB%99%E6%96%B0%E4%BA%BA%E7%9A%84%E8%AF%B4%E6%98%8E%E5%88%A0%E6%8E%89%E4%BA%86%E4%B8%80%E5%8D%8A/267)

<div class="topic-metadata">

**Author:** [@sunkeqi](https://buildx.do/u/sunkeqi)\
**回复:** 0\
**最近更新：:** [2026 年10 月 9 日 02:16 UTC](https://buildx.do/t/%E7%BB%99%E6%96%B0%E4%BA%BA%E7%9A%84%E8%AF%B4%E6%98%8E%E5%88%A0%E6%8E%89%E4%BA%86%E4%B8%80%E5%8D%8A/267 "2026-10-09T02:16:00Z")

</div>

删掉的是原理。留下的是命令、看哪一行、失败怎么办。新人当天跑通了。原理改到第二篇，第一篇不再负责讲完。

---

## [配置里哪些能动](https://buildx.do/t/%E9%85%8D%E7%BD%AE%E9%87%8C%E5%93%AA%E4%BA%9B%E8%83%BD%E5%8A%A8/98)

<div class="topic-metadata">

**Author:** [@suyanran](https://buildx.do/u/suyanran)\
**回复:** 1\
**最近更新：:** [2026 年10 月 5 日 01:44 UTC](https://buildx.do/t/%E9%85%8D%E7%BD%AE%E9%87%8C%E5%93%AA%E4%BA%9B%E8%83%BD%E5%8A%A8/98 "2026-10-05T01:44:00Z")

</div>

「配置里哪些能动」。 标注过的可以改。没标注的先别动。改之前复制一份旧的。 给后来的人看，所以写能照着做的步骤，不写感受。每一步写期望看到什么。看不到，就停在这一步，不要继续往下猜。步骤结束以后，用干净环境再做一次。自己的机器上能过，只能说明自己的机器上能过。 这篇按可以照着做的顺序写。每一步都写期望看到什么，不写‘然后应该就可以了’。出错时先留下完整输出、当时的配置、你期望发生什么。说明放在仓库里，不放在聊天记录里。给别人之前，…
