Unity的Package库在IDE里不显示API注释的解决方法
当你在代码里使用Package库的API的时候,比如Addressable和Unity.Entities等等,以Visual Studio为例,鼠标放到API上,会发现不显示注释:
然而按F12访问源代码,会发现代码里面是有注释的,而且Unity自己的包注释会非常的详细(Unity的API文档就是直接从这些注释生成的):
本质原因是Unity在编译这些Package的时候,没有生成XML注释文档,导致IDE找不到注释。而VS的Unity插件也没有智能到自动把注释定向到源文件那边去。
解决方法也不复杂。以Unity.Entities为例,首先建立一个文件夹,就叫Unity.Entities好了。
然后在里面创建一个Assembly Definition Reference。在Unity 6里,菜单项的位置如图所示:
给它起一个名字,比如Unity.Entities.Ref。然后在其Assembly Definition选中Unity.Entities,之后点击Apply:
如果只创建了这么一个Assembly Definition Reference,Unity有可能不会生成相应的Project文件。此时可以继续在文件夹里创建一个Script,随便起个名字,比如UnityEntitiesDummyScript,然后放着不管即可。
之后回到IDE内,再去把鼠标指向Unity.Entities里的东西,注释就完美的显示出来了:
我的注释框会这么华丽是因为装了Resharper的Enhanced Tooltip插件。
用以上方法,就可以把你想查看代码注释的Package都添加进来。比如Unity.Entities、Unity.Physics、Unity.NetCode等大部头。这样就不用总是按F12,或者跑到网页上看文档了。
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】博客园社区专享云产品让利特惠,阿里云新客6.5折上折
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· [翻译] 为什么 Tracebit 用 C# 开发
· 腾讯ima接入deepseek-r1,借用别人脑子用用成真了~
· Deepseek官网太卡,教你白嫖阿里云的Deepseek-R1满血版
· DeepSeek崛起:程序员“饭碗”被抢,还是职业进化新起点?
· RFID实践——.NET IoT程序读取高频RFID卡/标签