LuaLS / LuaLS/lua-language-server

@overload does not cooperate with @alias

未關閉
#1,793 3 則留言 0 個 reaction 已指派 0 人 在 GitHub 檢視

還沒有人認領這個 Issue。

enhancement feat/LuaCats Annotations
主要語言
Lua
星號
4.4k
分支
442
PR 合併指標
30 天內沒有已合併 PR

描述

### How are you using the lua-language-server?

Visual Studio Code Extension (sumneko.lua)

### Which OS are you using?

Windows

### What is the issue affecting?

Annotations, Diagnostics/Syntax Checking

### Expected Behaviour

When I define an @alias, an @overload command should be able to use it.

### Actual Behaviour

I receive the error:
```
`fun` expected. Lua Syntax Check.(luadoc-miss-fun-after-overload)
```

### Reproduction steps

```
---@alias what fun():"ok"

---@class huh
---@overload what
local huh = {}
```

貢獻指南

開啟貢獻指南

從這裡開始

  1. 先讀完整個 Issue,再讀專案的貢獻指南。
  2. 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
  3. Fork 儲存庫,在一個分支上完成修改。
  4. 送出 Pull Request,並在描述裡引用這個 Issue 編號。

研究方向

從 @alias 和 @overload 的 Lua 文件註解處理開始,使用 issue 中的重現作為第一個執行的案例。追蹤 @overload 產生診斷 luadoc-miss-fun-after-overload 的原因。完成的標準是:基於 alias 的 overload 在沒有該診斷的情況下被接受,同時現有的 overload 語法仍然有效。

由索引模型根據 Issue 內容生成。

評估

技術堆疊
lua
領域
devtools
Issue 類型
缺陷
難度
3/5
預估耗時
1-2 天
活躍度
停滯
描述清晰度
基本清楚
新手友好度
45/100

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。