强烈建议把3.0API参考搞好

Creator 3.x
#1

现在3.0版本的API太难用了

  1. 查找不方便，有时关键字输入了一半就卡住半天
  2. 查找不准确，很多时间查不到自己想要的API
10赞
#2

确实，3.0版本的API文档参考体验真的非常差：https://docs.cocos.com/creator/3.0/api/zh/classes/scene_graph.node-1.html

1赞
#3

确实，比2.x难用很多，经常搜不到东西

3赞
#4

确实。有时候搜个方法和类。找半天找不到。查找非常不方便

#5

做做好吧，求求啦

1赞
#6

+1…

#7

确实太难用了

#8

+1…

#9

+1…

#10

+1…

#11

3.0的镜头操作有人觉得不行么

#12

确实，现在3.0版本的API太不好用了，强烈建议修改成和2.X一样的API样式

#13

大伙儿顶上去让官方的人看到 :2:

#14

确实太难用了，大佬们搞好点啊

#15

api不是问题 主要是文档和api提示文件要跟上 :neutral_face:

#16

估计是搜索框的防抖没做好，输几个字母就卡半天

1赞
#17

感觉cc.d.ts应该是用某种插件自动根据ts代码生成的，官方一点都不检查生成出来的质量怎么样。

有的是declare了变量，但实际用的时候是undefined，比如 invalidateChildren(dirtyBit: __private.cocos_core_scene_graph_node_enum_TransformBit): void;中的__private。

再比如sys变量，export const sys: Record<string, any>;这能看出来个啥？

还有很多import的路径本就不存在，打开cc.d.ts一片红

#18

你说的这个插件是 https://github.com/shrinktofit/gift ，是 Cocos 开发维护的。

__private.cocos_core_scene_graph_node_enum_TransformBit

关于这个可能是这个工具的 BUG，你试下就传 Node.TransformBit.* 就行。

export const sys: Record<string, any>

这个东西引擎源码里面就是这么定义的类型。

还有很多import的路径本就不存在，打开cc.d.ts一片红

这个实际上是 TypeScript 的 BUG 噢。我们也在跟进中。

2赞
#19

源码里确实是这样定义类型的，而且这个类型在源码里大量的用到，但是在cc.d.ts里确实就让sys的提示显得非常难用了呀，每次要用，要不就是翻源码，要不就只能打印出来一点点看。

另外，cc.d.ts能不能出一种不是refrence引擎文件那个，而是像cocos2这样直接导出到项目文件夹里的方案，这样我们就可以把dts一起传到git上面去，即使dts发现有点问题，我们也可以暂时微调一下然后共享给其他开发人员。

#20

还是比如前面说到的sys类型，我们就可以手写更改sys的type，然后将改好的cc.d.ts共享给其他开发人员，这样就好用多了