开发者怒批华为云 C++ SDK 质量：文档失效、基础代码错误频出

[archliinux]

😄围观

https://github.com/huaweicloud/huaweicloud-sdk-cpp-v3/issues/7

[andrew2558]

这事就谁也别说谁了，文档写的好的真不多

[quxuanxuan]

华为云的 api 还老变，各种不兼容，用他们的 sdk 还不如自己实现鉴权，发送 http 请求

[clarkethan]

国内大厂，没有一个重视 sdk 的吧，反正我没看到过一个正常的，文档和 sdk 都惨不忍睹

[pepesii]

npu 相关的文档也是烂，code repo 和整个基础设施的自动化做的也是烂!
这个烂，是在使用过 nvdia 的 gpu-operator ，network-operator ，使用过海光的 k8s 组件后的对比下来的！

[ragnaroks]

说不定既不是班里成绩好的也不是成绩差的，而是随便找的外包写的

[lswlray]

我之前在 V2 上说过，去年陪儿子去参加了一个鸿蒙开发的培训
在学习的过程中，确实体验到存在这样的情况

我也曾经是国内最早一批的 SAP 开发者
在学习掌握 SAP 开发的过程中，也遇到过类似的情况

在我自己参与某 ERP 软件的开发平台的设计开发过程中
我就想过如何避免这种情况
我亲自编写了它的第一份开发手册、编写了帮助开发者的 VB IDE 开发插件
尽我最大的努力、想让学习这个 ERP 系统开发的朋友们能得到最好的体验
但，后来我放弃了 —— 因为系统发展的太快了，为了满足用户不断涌现的新需求、整个系统的发展太迅速了
这直接导致：我编写的开发手册、开发插件，想要做到第一时间包含新出现的函数、方法、事件...太难了
经过这个产品，我才明白了我在学习 SAP 开发过程中遇到的情况
我想，华为现在的问题，应该也是类似原因
想要解决这个问题，方法只有一个：给他们完善的时间。

[lswlray]

@lswlray

我当年编写开发手册、开发插件，都是我自己提出、自己做的
那时我很年轻、开发程序是我的兴趣爱好
当看到代理商和用户的开发人员捧着我编写的开发手册、用我编写的开发插件来实现他们的需求时
我非常的满足、所以我也从不在意为了实现这个目标、为了尽快的将新出现的函数、方法、事件含入加多少班

但后来，当我离开时、交到后续其他同事接手时，对他们来说，这就仅仅是一份工作任务而已
正如 V2 上大多数的开发者
也会有拿多少钱干多少活、能划水摸鱼就划水摸鱼的心思
手册和插件完善的越来越慢、甚至出现错漏也不足为奇
或许，华为负责这个工作的人员也会上 V2 ，也会有类似的想法
出现这样的情况也就很大概率了

所以，为何怒斥呢？
是因为我们自己可以有类似想法而别人不能有吗？
是因为我们自己可以不想加班、而负责这些资料维护的人必须要加班去完善吗？
还是，仅仅因为它是华为？

[LnTrx]

个人了解，华为云的特点是 UI 和文档都有不足，但好处是工单想找到懂技术的人比较容易，非工作时间也能找到人

[Mithril]

@lswlray 以我自己写代码对接各大云平台的经验来看，真的就是单纯因为它垃圾。

腾讯云阿里云虽然大家都在骂，但属于骂一骂也能捏着鼻子用的那种。什么文档跟不上，SDK 里有 Bug ，大家都习惯了。但华为云真的是会出那些新手都不会犯的 Bug 。

你去看看这个 Issue ，这就像你自己 Vibe 了一坨屎，压根没看过，别说 UT 了，甚至编译都没编一次你就发布出去了。你写完的代码你至少要编译一下吧？ CPP 这种语言甚至你连函数名都写错了，这都不要静态检查，你连编译都过不了。

这根本不仅仅是技术和态度问题，这是整个业务流程都出问题了。工作态度有好有坏大家都能理解，但这种玩意能直接放出来，说明压根就没有核查和 QA 流程。代码写完直接发布上线，别说 V2 上天天说的 AI Review 了，连最基础的 DevOps 都没有。都不指望你的 CI 跑测试和检查，编译都不做也能发布出来？

这是云服务，要作为你自己业务的基础设施的，这种质量的东西你敢用？

[kulove]

国内公司的产品就没一个文档写得好的 要说有 我就见过一个 LeanCloud

[jackOff]

我想起大学那会用他们加的 OCR 文档半天都写不对，找了一篇 CSDN 的文档才知道他们家文档维护是真的垃圾，API 都改版了也不更新文档给开发者看到最新的，要么管理不当，要么就是故意的

[strobber16]

华而不实，为所欲为

[zhmouV2]

@lswlray

不是用它的人不给人完善的时间

根据工作经验而是以下两点：
1. 需求排期太满，开发交付都忙不过来，哪里有时间写文档
2. 提供完善的文档相比别的工作无法体现"工作价值"(至少在管理或者内部绩效考核的方式而言），员工自然倾向投入产出比更高的业务

[alading11]

@zuosiruan 你和上面几个差着年份呢，估计你是最近几年毕业的

[wenrouxiaozhu]

@lswlray #27 更新 API 时必须同步更新文档，做好 CR 和版本管理应该问题不大...不过在大厂 CR 约等于无，都是直接合 master

[Luckykeeper]

看到这个，不得不吐槽一下了，不止是 C++ SDK ，Go 的也一样，之前要写一个把上传到 swr 的镜像自动改 public 的程序，结果试了下就 painc 了，搜了下 issues 看到下面这个链接差点笑死在工位，于是现学了一点儿 C# 然后换了 C# SDK 的搓了一版，然后把这个链接贴到了公司镜像仓的说明文档和同事一起笑，实在是无语以至于 issues 都不想发了，把链接贴在这里给大伙一起看乐子🤣

https://github.com/huaweicloud/huaweicloud-sdk-go-v3/issues/38#issuecomment-1909684768

[hikariming]

他们一直这样 - -
毕竟是搞定领导就 ok 的企业
开发者在他们那优先级很低吧

[Luckykeeper]

@Luckykeeper painc => panic 边笑边打飘了 2333

[sir283]

阿里都比华为好太多了，起码文档是给人看的，华为直接把你当入机了。

[nodesolar]

触发过华为云 OBS bug 还 阿里还是成熟的多， 经过大量验证的