iOS工程师专属：零基础搭建技术站全指南

文章配图，仅供参考

　　我原以为改到第九版，至少能卡进高考那几天上线。结果去年高考期间，服务器崩了三次——不是因为流量，是CDN回源路径里混进了两个带BOM头的MD文件，还是我凌晨三点手抖传错的。前端在 Slack 里敲：“你这文档页 footer 的间距，在 iPad Pro 上少 4pt。”我翻出规范 PDF，放大到 400%，发现色板里那个说不清的灰——Hex 是 #F5F5F7，Lab 值却飘在 L=96.3 a=-0.4 b=1.1，连我们自己设计系统里都没标这玩意儿叫啥名。没人问它为啥存在，就把它当祖宗供着。

　　谁在旁边刷短视频外放，《科目三》循环第七遍了。我摘下耳机问：“你有没有觉得，这个‘零基础’根本不是讲给新人听的？”他说没听清，我又喊一遍，他点头，继续刷。其实我也不确定是不是真这么想——但第八版被毙掉那天，PM 把手机怼我脸前：“你看人家小红书 iOS 团队写的搭建日记，评论区全是问 CocoaPods 替换成 Swift Package Manager 怎么搞。”我盯着那条笔记底下两百多条回复，一条没看，只注意到他们封面图用了圆角矩形 mask，而我们首页 banner 的圆角半径是 8.5，不是 8，也不是 9——是设计师硬算出来的视觉补偿值。

　　优胜劣汰？对。但这汰法不是筛人，是筛版本。你搭完第一版静态页，跑不通 Xcode；第二版勉强编译过，CI 卡在 lint；第三版加了 SwiftDoc 注释，文档生成器把 enum case 名全转成 camelCase 拆错了；第四版终于能本地预览，结果 Safari 浏览器里表格组件 overflow-x 撑爆 viewport——但用户不关心，他们只点开页面，扫一眼标题，觉得“哦，这是给 iOS 工程师看的”，然后关掉。第五版……算了，记不清是第几版了。大概那个数吧。

　　窗台上的绿萝死了半盆，叶子卷边发黄，根还泡在积水里。保洁阿姨上周擦玻璃时顺手浇了一次水，浇完就走了。我不敢动，怕一挪花盆露出底下压着的那叠 A4 打印稿——全是早期方案里被毙掉的交互流程图，其中一张画着“从 Podfile 迁移 → 自动化脚本校验 → 提示失败原因”的分支逻辑，密密麻麻写满批注：“此路径无法覆盖私有库证书场景”“CI 环境无 Keychain 访问权限”“建议改为手动介入+日志溯源”。没人要这份东西，但它现在就在那儿，和干了的马克杯并排躺着。

　　显示器有点色偏，左边偏青，右边泛黄，中间刚好是我码字的编辑器窗口。我调过 gamma，也重启过 DisplayPort，没用。后来发现只要把 Finder 窗口拖到右侧边缘，再往左挪两像素，整个色彩感知就稳了——这事儿我告诉前端，他试了三分钟，说“那你以后就别动窗口了”。我说行，结果半小时后他自己把窗口拉满全屏，色偏又回来了。

　　你知道最反常识的是啥吗？我们花两个月定组件库、写文档、做 demo 页，最后真正帮到人的，反而是技术站里那个藏在 /faq/ios-deploy-tips.md 里的 Shell 脚本片段——三行命令，清 DerivedData + 杀 simulator + 清 build cache。它没进任何导航，没被任何人提 PR 改过，连 markdown 语法都写漏了一个缩进，但有人搜到，复制粘贴，好了。而我们精心设计的“零基础搭建路径图”，用了六个状态节点、四个条件判断、三种颜色编码，至今没人点开过 SVG 源码。

　　我承认自己那份没人看的作品集。首页放了三张截图：一页是 Sketch 文件缩略图，一页是 GitHub Pages 预览链接，一页是某次内部分享的现场照片——PPT 第七页写着“工程即文档，文档即交付”。照片里我嘴张着，手悬在空中，表情介于困惑和打哈欠之间。底下观众没人抬头，全低头刷手机。那一刻我觉得自己像在演默剧，还是没人买票的那种。

　　所以你现在要是真想搭一个，别等设计验收。先跑通 `jazzy --module-root . --output docs --author "iOS" --theme fullwidth`，哪怕输出页面丑得像九十年代 GeoCities。然后把你最常重装 Xcode 的那段话，贴进去。别起标题，就写：“如果你删错了 Pods 目录，请立刻拔掉 MacBook 充电器，长按 power 键 12 秒。”别的，往后推。推到你能推不动为止。

（编辑：草根网）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!