【从零开始游戏开发】EmmyLua插件注解功能

你知道的越多，你不知道的越多 🇨🇳🇨🇳🇨🇳
点赞再看，养成习惯，别忘了一键三连哦 👍👍👍
文章持续更新中 📝📝📝

---

1️⃣前言🔥🔥🔥

网上配置 EmmyLua 的方法很多，此处就不做赘述（因此前提是你已经安装配置完EmmyLua）

本文仅是对 EmmyLua插件 内 注解功能 用法的代码演示。因为网上大部分EmmyLua配置教程中都没对此部分进行讲解，而实际lua开发时EmmyLua的注解功能几乎必不可缺，故作此文

2️⃣ 注解的目的🔥🔥🔥

我们在编写C#脚本时，IDE的相关插件能提示各类方法或成员以及描述：

但Lua内，即便安装完EmmyLua，不写注解的话，也就没有任何提示（灰色提示仅表示刚有写过该参数而已，完全不知道是成员变量或方法）：

因此EmmyLua注解功能就是为了解决该问题：模拟实现OOP编程中代码提示

3️⃣注解用法🔥🔥🔥

🔑类的声明
基本格式：--@class MY_TYPE[:PARENT_TYPE] [@comment]

---@class Person 人
Person = {};

---@class Gamer : Person 玩家
Gamer = {};

🔑类的额外属性
即使该类未持有某属性，也可以通过添加注解，在提示内出现（PS：其实EmmyLua实现UnityAPI的提示也是基于此的）

基本格式：---@field [public|protected|private] field_name FIELD_TYPE[|OTHER_TYPE] [@comment]

---@class Person 人
---@field public Name string 名字
---@field private m_Age number 年龄
Person = {
    Name = "",
};

🔑变量的类型
基本格式：---@type MY_TYPE[|OTHER_TYPE] [@comment]

PS：按上述官方用法，comment描述应当放在末尾，但我这试了下type不大行，可以放在顶部

---@type number 我的ID
myId = 1;

---玩家的表
---@type table<number, Gamer>
gamersTable = {};

---@type Person Person实例
personA = Person:Create();
---@type Gamer Gamer实例
gamerA = Gamer:Create();

🔑函数
标记函数定义参数的类型：---@param param_name MY_TYPE[|other_type] [@comment]
标记函数的返回值类型：---@return MY_TYPE[|OTHER_TYPE] [@comment]

---取得台词
---@param isCN boolean 是否是中文
---@param id number 台词字典ID
---@return string 台词
function GetLines(isCN, id)
    local str = "";    -- do something
    return str;
end

备注
在IDEA下，对目标使用Alt+Enter快捷键（或点小灯泡），可较方便自动补全注解：

4️⃣完整示例🔥🔥🔥

现有Person基类，Gamer类继承自Person，在Main.lua内实现两个类的创建及使用（直接粘到本地跑就行）：

🔑Main.lua：

require("Person");
require("Gamer");

---@type Person
local pa = Person:Create("joker", 18);
pa:ShowInfo();
pa:ReName("Joker");
pa:ShowInfo()

---@type Gamer
local ga = Gamer:Create("fox", 19, nil, nil);
ga:ShowInfo();
ga:ReName("Fox");
ga:ReGamerInfo("123", "456");
ga:ShowInfo();

🔑Person.lua：

---@class Person 人类型
---@field public Name string 名字
---@field private m_Age number 年龄
Person = {
    Name = "",
    m_Age = 0,
};

Person.__index = Person;

---Create
---@param name string
---@param age number
function Person:Create(name, age)
    ---@type Person
    local t = {};

    setmetatable(t, Person);

    t:ReName(name);
    t:ReAge(age);

    return t;
end

---ReName
---@param newName string
---@public
function Person:ReName(newName)
    self.Name = newName;
end

---ReAge
---@param newAge number
---@private
function Person:ReAge(newAge)
    self.m_Age = newAge;
end

---ShowInfo
---@public
function Person:ShowInfo()
    print("Name = " .. self.Name .. ", Age = " .. self.m_Age);
end

🔑Gamer.lua：

require("Person")

---@class Gamer : Person 玩家
---@field private SW string SW码
---@field private SteamId string Steam链接
Gamer = {
    SW = "",
    SteamId = "",
};

Gamer.__index = Gamer;
setmetatable(Gamer, Person);

function Gamer:Create(name, age, sw, steamId)
    ---@type Gamer
    local t = {};
    t = Person:Create(name, age);

    setmetatable(t, Gamer);

    t:ReGamerInfo(sw, steamId);

    return t;
end

---ReGamerInfo
---@param sw string
---@param steamId string
---@public
function Gamer:ReGamerInfo(sw, steamId)
    self.SW = sw or "0";
    self.SteamId = steamId or "0";
end

---ShowInfo
---@public
function Gamer:ShowInfo()
    print("Name = " .. self.Name .. ", Age = " .. self.m_Age .. ", SW = " .. self.SW .. ", SteamId = " .. self.SteamId);
end

PS：可以用 在Lua中实现面向对象特性——模拟类、继承、多态 - 马三小伙儿 大佬这篇的代码练手

🎁🌻🌼🌸 粉丝福利来喽 🎁🌻🌼🌸

1. 免费领取海量资源 🎁
   简历自测评分表、Unity职级技能表、面试题库、入行学习路径等
2. 《Unity游戏开发五天集训营 》50个名额 🎁
   我给大家争取到了 50个《游戏开发五天集训营 》名额，原价198，前50个免费
   扫码加入，暗号小听歌
   即可参加ARPG狼人战斗系统、饥荒生存类游戏开发、回合制RPG口袋妖怪游戏等游戏开发训练营
3. 额外抽奖机会🎁
   参加游戏训练营、还有机会获得大厂老师在线面试指导、或者有机会获得价值1998元的《Unity极速入门与实战》课程

🔻🔻🔻🔻 扫下方二维码，获取游戏开发福利，暗号小听歌 🔻🔻🔻🔻