下个版本会升级到0.7.0, 届时java版本的语言服务会默认禁用
NEW 支持---@verson注解, 格式为: ---@version [>|<|>=|<=] [<framework>] <version>, ...
NEW 支持配置runtime.frameworkVersions, 配置格式为:
{
"runtime": {
"frameworkVersions": [
"openresty 1.2.0"
]
}
}NEW 支持 diagnostic.globalsRegex, 用于配置全局变量的正则表达式, 例如:
{
"diagnostics": {
"globalsRegex": [
"^ngx\\."
]
}
}NEW 优化代码补全, 支持tablefield补全, 支持元字段补全
NEW 支持CodeLens功能, 通过配置codeLens.enable开启, 例如:
{
"codeLens": {
"enable": true
}
}NEW EmmyLuaAnalyzer项目新增EmmyLua.Cli工程, 用于生成文档, 代码检查等功能.
NEW 命令行工具支持生成文档目前实现非常简陋需要优化.
FIX 修复不少细节上的BUG
NEW 重构声明算法, 优化Hover时的提示, 现在hover时, 会展开alias的选项, 并且增加Go to 类型的跳转
NEW 兼容LuaLs的一些跨行联合语法
NEW 生成了schema.json文件, 用于支持json文件的补全
NEW 新增deprecated的渲染, 和一些私有字段的访问检查
NEW 新增配置用于设置autoRequire时的补全函数名以及文件命名法的转换
NEW 重构算法, 优化内存占用, 减少30%的内存占用
NEW 支持工作区符号搜索
FIX 修复配置类的初始化问题导致的documentLink报错
NEW 现在所有能够填写路径的地方, 都支持相对路径, 绝对路径, 以及$${workspaceFolder}指代工作区 ~指代用户目录
NEW 增加inlayHint配置, 实现localHint和overrideHint
NEW 实现DocumentLink功能, 可以跳转到相关文件
NEW 实现字符串中的资源文件补全, 需要添加配置:
{
"resource": {
"paths": [
"absolute path to resource folder"
],
}
}FIX 修复右侧表达式为unknown时, 左侧类型会被强制转换为匿名类型的问题
NEW 实现后缀补全功能, 输入标识符后输入 '@' 即可获得后缀补全
FIX 修复双倍全局变量的问题
NEW 兼容luals一些语法:
- 返回类型可以是 ... 或者 ...string,
- 兼容 doc attribute, 例如---@enum (partial) A, 但并未实现相关功能
- 兼容返回类型可空简化描述, 例如---@return string?, 但并未实现相关功能
NEW 支持可变模板参数声明, 主要用于实现unpack逻辑, 例如:
---@generic T...
---@param a [T...]
---@return T...FIX 修复hover和inlayhint时, 表结构类型的字段提示问题
FIX 修复多返回值函数, 后续返回延续的前一个的问题
NEW 对无法推断类型的变量, 会默认给予一个匿名类型
NEW 现在支持从配置文件配置语言服务, 你可以在工作区创建.emmyrc.json, 具体格式目前是:
{
"completion": {
"autoRequire": true,
"callSnippet": false,
"postfix": "@"
},
"diagnostics": {
"disable": [],
"globals": []
},
"hint": {},
"runtime": {
"version": "Lua5.4"
},
"workspace": {
"ignoreDir": [
"test"
],
"library": [],
"workspaceRoots": [],
"preloadFileSize": 2048000
}
}NEW 现在提供工作区诊断和工作区禁用诊断
NEW 支持在工作区内配置root路径, 这样require路径将会从root开始, root可以配置多个
NEW 支持配置第三方库目录
NEW 支持通过_G定义全局变量, 例如_G.aa = 123, 但是找不到引用目前
FIX 修复全局变量判断问题
FIX 修复双倍打开文件的BUG
NEW 增加大量代码片段
NEW 推断回调函数的参数类型
NEW 强化inlayHint, 函数调用参数上的inlayHint可以点击跳转
NEW 提供continue补全(转化为goto continue)
NEW 完善诊断管理, 可以通过---@diagnostic 系列注解关闭当前行和当前文件的诊断
NEW 提供未定义全局变量的诊断
FIX 临时把add改为TryAdd, 修复启动错误
FIX 修复注释中的缩进显示
NEW 隐式继承, 例如:
---@class A
local a = enum {
aaa = 123
}此时A类将隐式继承右侧表达式的类型
FIX 修复多线程问题
FIX 修复debug inline values过多的问题
FIX 修复一些补全问题
NEW 增加一个显示解析进度的条
NEW 替换插件端的debug inline values特性, 改为语言服务实现
NEW 实现函数环境下self字段的直接补全而不用写self
FIX 修复部分全局变量没有标记为红色的BUG
FIX 重新启用goto和break的相关检查
FIX 修改项目排除逻辑
FIX 优化内存占用
FIX 修复重命名时光标在标识符右侧导致无法重命名的问题
FIX 插件会在启动时试图读取.luarc.json文件, 功能未实现
FIX 修复双倍服务器的问题
NEW 支持emmylua经典代码渲染
FIX 优化一点内存占用
FIX 暂时屏蔽控制流分析给出的错误诊断
NEW 修复索引表达式找不到引用的问题
NEW 支持读取配置, 但是目前没有作用
FIX 不索引大文件(超过200kb)
FIX 修复形如 { x:number} 的类型解析错误
FIX 修复对标准库的读取
NOTE 全新语言服务基于dotnet sdk 8, 需要自行下载
NEW 可选的使用新的语言分析后端，新的分析后端支持更多的特性，包括但不限于：
- 真泛型类
- 复杂泛型函数的类型推断
- 运算符重载
- 多重继承
- 接口和接口继承
- enum和alias的常量补全
- 支持元组类型 [int, int, int]
- 支持---@async标注
- Emmylua doc可以在任意处换行, 并且支持多行注释
- 支持 #123456 格式的文本的color显示
- 支持基于代码补全的auto require (如果模块存在返回值)
- 调整require的路径显示
- 兼容LuaLs的大部分doc标注, 但功能并未完全实现
NOTE java版本的语言服务会和C#写的语言服务共存, 去settings下搜索emmylua.new开启后重启vscode即可, 版本号暂时升级到0.6, 经过1到2个月的BUG修复期之后, 版本会升级到0.7, 此时会移除java版本的语言服务.
再经过一段时间的稳定, vscode-emmylua版本号将升级到1.0
新语言服务的地址: https://github.com/CppCXY/EmmyLuaAnalyzer
NEW 调试器支持IPV6地址, 所有dns会优先解析为IPV6, 例如localhost将会被解析为IPV6地址
FIX 因为vscode的更新使得nodejs的net模块对localhost解析出现问题, 导致调试器无法连接到目标进程
FIX 修复一个调试崩溃问题
REFACTOR 重构launch调试, 支持使用vscode的debug窗口展示打印, 也可以选择开启新的console窗口显示打印
FIX 修复语言服务0.5.15引入的不加载工作区的问题
NOTE 最低VSCODE版本要求1.79
REFACTOR 重新组织调试器适配器代码结构, 在开发模式下会和插件同进程便于调试.
REFACTOR 重构调试器协议部分代码
NEW 调试器支持运行时设置表达式的功能(对本地变量无效, 需要后续修改)
REFACTOR 语言服务重构多线程方面的内容
NOTE 修修补补又一年
FIX 修复调试问题, 调试器升级到1.5.1
FIX 修复代码补全时因为alias导致的递归爆栈
NEW 加个显示emmylua运行状态的item bar
CHANGE 移除找不到java时右下角的显示
CHANGE 允许停用emmylua语言服务
FIX 修复使用emmylua-unity时, 继承unity类之后无法提示的问题
NEW 好久没更了更一下
NEW 调试器升级到1.5.0
NEW 修复emmylua-unity相关跳转问题
NEW 这里报告一下语言服务开发进度, 没有进度 over.
FIX 现在支持打开单文件, 修复打开单文件语言服务的报错
FIX 找不到函数签名时返回空
CHANGE 取消工作区诊断
CHANGE 代码诊断分成两部分, 一部分是语法实时检查, 一部分是语义检查, 语义检查仅仅在打开文件或者保存文件时触发
FIX 下载语言服务和调试器失败
UPDATE 调试器升级到1.4.0版本，主要变更是弃用rapidjson改为nlohmann/json
CHANGE 重新启用工作区诊断
UPDATE 语言服务客户端升级到8.0.2
UPDATE 最低vscode依赖版本改为1.70.0
CHANGE 停用工作区诊断，一般诊断改为在主线程运行
FIX 修复调试时，chunkname远长于打开的工作区的时候路径搜索的问题
FIX 试图修复卡加载问题
FIX 修复跳转定位错误
CHANGE 修改各种提示细节
NEW 插件支持被外部插件扩展api。
NEW 新的emmylua-unity插件已经上架插件商店
FIX 修复调试找不到路径的bug
FIX 修复重命名无效的bug
FIX 修复override hint不可跳转的BUG
FIX 修复inlayhint的错乱
CHANGE 修改调试时命中文件的方式。
FIX 修复使用工作区诊断可能带来的性能问题
CHANGE 代码诊断，inlayHint，代码补全更新到语言服务3.17规定的方式
CHANGE 优化亿点细节
FIX 修复在某些框架下, 因为计算元表导致的栈混乱进而导致的进程崩溃。thanks @浪迹天涯 提供的复现工程
NEW emitter风格重载扩展支持到主签名的第一个参数是number时可以这样写：
---@overload fun(level: "ngx.INFO", info)
---@overload fun(level: "ngx.WARN", msg)
---@param level number
function ngx.log(level, ...) endNEW @field注解现在支持数字field描述:
---@field [1] number
---@field [2] string也支持数字或者字符串的索引描述:
---@field [number] string
---@field [string] string几种方式可以共存于类定义。
NEW 支持emitter风格重载：
---@overload fun(a: "data", data)
---@overload fun(a: "listen", aa, bb, cc)
---@param a string
local function f(a, bbb)
endNEW 枚举可以标记继承类:
---@enum aaaa: number枚举继承自某类之后参数类型检查会检查参数是否符合父类。
NEW 支持基于枚举的重载：
---@enum IO: number
IO = {
Input = 1,
Output = 2
}
---@overload fun(type: "IO.Input", in)
---@overload fun(type: "IO.Output", writeHandle)
---@param type IO
local function f(type, ...)
endNOTE 上面新增的重载风格必须是枚举/字符串处于函数第一个参数
FIX 修复参数诊断时提示的文本错误
NEW 实验性的支持特性interface该特性有如下特点:
特点1 接口有如下书写形式:
---@interface A
---@field a number
---@field b number特点2 接口可以被继承：
---A是上文的interface A
---@class C : A继承接口时，诊断会检查类是否实现了接口的成员
特点3 当接口被用作参数类型时，在函数参数验证的特性开启后，会检查传入的参数是否符合接口，如果传入的参数并非继承自该接口，或者是表表达式，则会检查是否符合接口定义的每一个成员
限制 接口不能继承其他类或者其他接口
NEW 多重接口继承，类型声明现在可以以如下形式多重继承接口
---@interface b
---@interface c
---@class a: b, c限制: 多重继承时，仅允许继承一个class，其余的只能是interface，且class只允许出现在第一个继承位
NEW 当变量本身仅有一处定义，则变量被视为常量。如果变量被视作常量而且是字符串或者数值类型，则代码补全和悬浮提示变量时，显示常量。
NEW 重启deprecated渲染，但是仅当对应配置勾选时有效
FIX 修复上一个PR带来的调试假死的问题（回滚）
NEW emmylua调试器编译标准提高到C++11之前是C++0X
FIX 修复多线程问题
FIX 正确支持macos arm64架构下的调试
NEW 新增函数参数上的可空描述比如 ---@param a? number
NEW 函数参数检查将会检查参数数量是否过少，如果参数过少而后续参数没有显示标记可空则会报错
NEW 调试时，如果不能根据chunkname找到文件会试图以以当前打开的工作区为根目录再找一次 contribute by @whitecostume
NEW 其他细节更新
FIX 将其他扩展后缀关联到lua时没有解析的BUG
FIX 修复因为诊断带来的性能问题，诊断被移到守护线程执行。代码解析完后，代码提示和相关渲染会立即可用
FIX 修复默认选项下解析过慢的问题, 暂时移除deprecated相关诊断
NEW 不识别的Tag不再警告
NEW 实验性的支持一系列检查配置包括赋值安全检查， 子域存在性检查, 未定义变量使用检查, 函数参数类型安全
NEW 支持类方法override父类同名函数时的hint
NEW 其他小细节更新
FIX jdk改回8
FIX 由于编译环境变更有许多崩溃现象，现在临时改回来
NEW upvalue的下划线颜色可配置，当配置内容为空的时候不显示下划线
NEW deprecated注解对全局函数有效
NEW 实验性的支持子域存在性检查
NEW 在定义处使用ctrl跳转会跳转到用法
FIX CodeLens error
FIX 修复@private注解不能正确作用的bug
NEW 支持@deprecated注解和相关的诊断
NEW 实验性的支持字符串内联表达式注解string<T>, 当函数参数使用该注解时，对应的函数调用上，字符串内会提示T类的field，可使用string<_G>表示字符串内提示全局变量
FIX 修复一个因为使用fixPath导致的崩溃
恢复更新
代码提示：
- 支持lua5.4语法
- 支持通过标注参数类型为函数，补全匿名回调函数
- 修改函数签名显示
- 支持参数类型诊断(实验性)
- 支持枚举类型标注enum(实验性)
代码渲染：
- 支持param hint
- 支持local hint
- 支持vararg hint
- 支持未使用变量渲染为灰色
- upvalue修改为黄色下划线
代码折叠：
- 支持通过--region和--endregion实现区块折叠
- 支持连续require语句折叠，连续require语句被识别为import区块，可以通过相关vscode设置直接折叠打开文件的require语句
lua语言:
- 移除lua语言定义配置文件直接采用vscode新的内建的lua语言定义
格式化:
- 移除现行的格式化算法，EmmyLua插件不再提供格式化算法
- 格式化交由插件EmmyLuaCodeStyle实现
调试:
- 支持条件断点，命中次数断点，日志记录点
- 支持lua5.4调试
- 支持苹果m1下的调试
- 附加调试支持指定匹配进程名
- 调试提供debug inline variable
- 在windows上提供launch调试，launch调试支持使用windows terminal
JVM:
- kotlin修改为1.6版本，gradle修改为6.1.1版本
- jdk推荐使用jdk11
- JVM参数移除CMS采用G1GC
BUG:
- 修复键入代码的过程中染色错误的问题
- 修复因为外部更新没有即时刷新索引的问题
- 修复函数签名错误
- 重写调试器修复常见崩溃问题