summaryrefslogtreecommitdiff
path: root/doc/zh-cn
diff options
context:
space:
mode:
author最萌小汐 <sumneko@hotmail.com>2022-06-09 02:22:30 +0800
committer最萌小汐 <sumneko@hotmail.com>2022-06-09 02:22:30 +0800
commit05fc6b11b399f3024679d9ca9226b00cc193ae86 (patch)
treebd4b6e04b670cc58baad042dfabf146d2e44dfd2 /doc/zh-cn
parentc481991fee74022dd261fab3bd5f07f472b9f9ac (diff)
downloadlua-language-server-05fc6b11b399f3024679d9ca9226b00cc193ae86.zip
update doc
Diffstat (limited to 'doc/zh-cn')
-rw-r--r--doc/zh-cn/config/config.md741
1 files changed, 603 insertions, 138 deletions
diff --git a/doc/zh-cn/config/config.md b/doc/zh-cn/config/config.md
index 83839806..43e8986c 100644
--- a/doc/zh-cn/config/config.md
+++ b/doc/zh-cn/config/config.md
@@ -3,206 +3,281 @@
输入内容看起来是个文件名时,自动 `require` 此文件。
## type
-`boolean`
+
+```ts
+boolean
+```
## default
-`true`
+```json
+true
+```
# completion.callSnippet
显示函数调用片段。
## type
-`string`
-
-## default
-`"Disable"`
+```ts
+string
+```
## enum
* `"Disable"`: 只显示 `函数名`。
* `"Both"`: 显示 `函数名` 与 `调用片段`。
* `"Replace"`: 只显示 `调用片段`。
+## default
+
+```json
+"Disable"
+```
# completion.displayContext
预览建议的相关代码片段,可能可以帮助你了解这项建议的用法。设置的数字表示代码片段的截取行数,设置为`0`可以禁用此功能。
## type
-`integer`
+
+```ts
+integer
+```
## default
-`0`
+```json
+0
+```
# completion.enable
启用自动完成。
## type
-`boolean`
+
+```ts
+boolean
+```
## default
-`true`
+```json
+true
+```
# completion.keywordSnippet
显示关键字语法片段
## type
-`string`
-
-## default
-`"Replace"`
+```ts
+string
+```
## enum
* `"Disable"`: 只显示 `关键字`。
* `"Both"`: 显示 `关键字` 与 `语法片段`。
* `"Replace"`: 只显示 `语法片段`。
+## default
+
+```json
+"Replace"
+```
# completion.postfix
用于触发后缀建议的符号。
## type
-`string`
+
+```ts
+string
+```
## default
-`"@"`
+```json
+"@"
+```
# completion.requireSeparator
`require` 时使用的分隔符。
## type
-`string`
+
+```ts
+string
+```
## default
-`"."`
+```json
+"."
+```
# completion.showParams
在建议列表中显示函数的参数信息,函数拥有多个定义时会分开显示。
## type
-`boolean`
+
+```ts
+boolean
+```
## default
-`true`
+```json
+true
+```
# completion.showWord
在建议中显示上下文单词。
## type
-`string`
-
-## default
-`"Fallback"`
+```ts
+string
+```
## enum
* `"Enable"`: 总是在建议中显示上下文单词。
* `"Fallback"`: 无法根据语义提供建议时才显示上下文单词。
* `"Disable"`: 不显示上下文单词。
+## default
+
+```json
+"Fallback"
+```
# completion.workspaceWord
显示的上下文单词是否包含工作区中其他文件的内容。
## type
-`boolean`
+
+```ts
+boolean
+```
## default
-`true`
+```json
+true
+```
# diagnostics.disable
禁用的诊断(使用浮框括号内的代码)。
## type
-`array<string>`
+
+```ts
+Array<string>
+```
## default
-`[]`
+```json
+[]
+```
# diagnostics.disableScheme
不诊断使用以下 scheme 的lua文件。
## type
-`array<string>`
+
+```ts
+Array<string>
+```
## default
-`[ "git" ]`
+```json
+["git"]
+```
# diagnostics.enable
启用诊断。
## type
-`boolean`
+
+```ts
+boolean
+```
## default
-`true`
+```json
+true
+```
# diagnostics.globals
已定义的全局变量。
## type
-`array<string>`
+
+```ts
+Array<string>
+```
## default
-`[]`
+```json
+[]
+```
# diagnostics.ignoredFiles
如何诊断被忽略的文件。
## type
-`string`
-## default
-
-`"Opened"`
+```ts
+string
+```
## enum
* `"Enable"`: 总是诊断这些文件。
* `"Opened"`: 只有打开这些文件时才会诊断。
* `"Disable"`: 不诊断这些文件。
+## default
+
+```json
+"Opened"
+```
# diagnostics.libraryFiles
如何诊断通过 `Lua.workspace.library` 加载的文件。
## type
-`string`
-## default
-
-`"Opened"`
+```ts
+string
+```
## enum
* `"Enable"`: 总是诊断这些文件。
* `"Opened"`: 只有打开这些文件时才会诊断。
* `"Disable"`: 不诊断这些文件。
+## default
+
+```json
+"Opened"
+```
# diagnostics.neededFileStatus
@@ -212,216 +287,431 @@
## type
-`object`
+
+```ts
+object<string, string>
+```
+
+## enum
+
+* `"Any"`
+* `"Opened"`
+* `"None"`
+## default
+
+```json
+{
+ "ambiguity-1": "Any",
+ "await-in-sync": "None",
+ "circle-doc-class": "Any",
+ "close-non-object": "Any",
+ "code-after-break": "Opened",
+ "codestyle-check": "None",
+ "count-down-loop": "Any",
+ "deprecated": "Opened",
+ "different-requires": "Any",
+ "discard-returns": "Opened",
+ "doc-field-no-class": "Any",
+ "duplicate-doc-alias": "Any",
+ "duplicate-doc-field": "Any",
+ "duplicate-doc-param": "Any",
+ "duplicate-index": "Any",
+ "duplicate-set-field": "Any",
+ "empty-block": "Opened",
+ "global-in-nil-env": "Any",
+ "lowercase-global": "Any",
+ "missing-parameter": "Opened",
+ "need-check-nil": "Opened",
+ "newfield-call": "Any",
+ "newline-call": "Any",
+ "no-unknown": "None",
+ "not-yieldable": "None",
+ "redefined-local": "Opened",
+ "redundant-parameter": "Opened",
+ "redundant-return": "Opened",
+ "redundant-value": "Opened",
+ "spell-check": "None",
+ "trailing-space": "Opened",
+ "type-check": "None",
+ "unbalanced-assignments": "Any",
+ "undefined-doc-class": "Any",
+ "undefined-doc-name": "Any",
+ "undefined-doc-param": "Any",
+ "undefined-env-child": "Any",
+ "undefined-field": "Opened",
+ "undefined-global": "Any",
+ "unknown-diag-code": "Any",
+ "unused-function": "Opened",
+ "unused-label": "Opened",
+ "unused-local": "Opened",
+ "unused-vararg": "Opened"
+}
+```
# diagnostics.severity
修改诊断等级。
## type
-`object`
+
+```ts
+object<string, string>
+```
+
+## enum
+
+* `"Error"`
+* `"Warning"`
+* `"Information"`
+* `"Hint"`
+## default
+
+```json
+{
+ "ambiguity-1": "Warning",
+ "await-in-sync": "Warning",
+ "circle-doc-class": "Warning",
+ "close-non-object": "Warning",
+ "code-after-break": "Hint",
+ "codestyle-check": "Warning",
+ "count-down-loop": "Warning",
+ "deprecated": "Warning",
+ "different-requires": "Warning",
+ "discard-returns": "Warning",
+ "doc-field-no-class": "Warning",
+ "duplicate-doc-alias": "Warning",
+ "duplicate-doc-field": "Warning",
+ "duplicate-doc-param": "Warning",
+ "duplicate-index": "Warning",
+ "duplicate-set-field": "Warning",
+ "empty-block": "Hint",
+ "global-in-nil-env": "Warning",
+ "lowercase-global": "Information",
+ "missing-parameter": "Warning",
+ "need-check-nil": "Warning",
+ "newfield-call": "Warning",
+ "newline-call": "Information",
+ "no-unknown": "Information",
+ "not-yieldable": "Warning",
+ "redefined-local": "Hint",
+ "redundant-parameter": "Warning",
+ "redundant-return": "Warning",
+ "redundant-value": "Warning",
+ "spell-check": "Information",
+ "trailing-space": "Hint",
+ "type-check": "Warning",
+ "unbalanced-assignments": "Warning",
+ "undefined-doc-class": "Warning",
+ "undefined-doc-name": "Warning",
+ "undefined-doc-param": "Warning",
+ "undefined-env-child": "Information",
+ "undefined-field": "Warning",
+ "undefined-global": "Warning",
+ "unknown-diag-code": "Warning",
+ "unused-function": "Hint",
+ "unused-label": "Hint",
+ "unused-local": "Hint",
+ "unused-vararg": "Hint"
+}
+```
# diagnostics.workspaceDelay
进行工作区诊断的延迟(毫秒)。当你启动工作区,或编辑了任意文件后,将会在后台对整个工作区进行重新诊断。设置为负数可以禁用工作区诊断。
## type
-`integer`
+
+```ts
+integer
+```
## default
-`3000`
+```json
+3000
+```
# diagnostics.workspaceRate
工作区诊断的运行速率(百分比)。降低该值会减少CPU占用,但是也会降低工作区诊断的速度。你当前正在编辑的文件的诊断总是全速完成,不受该选项影响。
## type
-`integer`
+
+```ts
+integer
+```
## default
-`100`
+```json
+100
+```
# format.defaultConfig
**Missing description!!**
## type
-`object`
+
+```ts
+Object<string, string>
+```
## default
-`{}`
+```json
+{}
+```
# format.enable
启用代码格式化程序。
## type
-`boolean`
+
+```ts
+boolean
+```
## default
-`true`
+```json
+true
+```
# hint.arrayIndex
在构造表时提示数组索引。
## type
-`string`
-
-## default
-`"Auto"`
+```ts
+string
+```
## enum
* `"Enable"`: 所有的表中都提示数组索引。
* `"Auto"`: 只有表大于3项,或者表是混合类型时才进行提示。
* `"Disable"`: 禁用数组索引提示。
+## default
+
+```json
+"Auto"
+```
# hint.await
**Missing description!!**
## type
-`boolean`
+
+```ts
+boolean
+```
## default
-`true`
+```json
+true
+```
# hint.enable
启用内联提示。
## type
-`boolean`
+
+```ts
+boolean
+```
+
+## default
+
+```json
+false
+```
# hint.paramName
在函数调用处提示参数名。
## type
-`string`
-
-## default
-`"All"`
+```ts
+string
+```
## enum
* `"All"`: 所有类型的参数均进行提示。
* `"Literal"`: 只有字面量类型的参数进行提示。
* `"Disable"`: 禁用参数提示。
+## default
+
+```json
+"All"
+```
# hint.paramType
在函数的参数位置提示类型。
## type
-`boolean`
+
+```ts
+boolean
+```
## default
-`true`
+```json
+true
+```
# hint.setType
在赋值操作位置提示类型。
## type
-`boolean`
+
+```ts
+boolean
+```
+
+## default
+
+```json
+false
+```
# hover.enable
启用悬停提示。
## type
-`boolean`
+
+```ts
+boolean
+```
## default
-`true`
+```json
+true
+```
# hover.enumsLimit
当值对应多个类型时,限制类型的显示数量。
## type
-`integer`
+
+```ts
+integer
+```
## default
-`5`
+```json
+5
+```
# hover.expandAlias
**Missing description!!**
## type
-`boolean`
+
+```ts
+boolean
+```
## default
-`true`
+```json
+true
+```
# hover.previewFields
悬停提示查看表时,限制表内字段的最大预览数量。
## type
-`integer`
+
+```ts
+integer
+```
## default
-`20`
+```json
+20
+```
# hover.viewNumber
悬停提示查看数字内容(仅当字面量不是十进制时)。
## type
-`boolean`
+
+```ts
+boolean
+```
## default
-`true`
+```json
+true
+```
# hover.viewString
悬停提示查看字符串内容(仅当字面量包含转义符时)。
## type
-`boolean`
+
+```ts
+boolean
+```
## default
-`true`
+```json
+true
+```
# hover.viewStringMax
悬停提示查看字符串内容时的最大长度。
## type
-`integer`
+
+```ts
+integer
+```
## default
-`1000`
+```json
+1000
+```
# misc.parameters
VSCode中启动语言服务时的[命令行参数](https://github.com/sumneko/lua-language-server/wiki/Command-line)。
## type
-`array<string>`
+
+```ts
+Array<string>
+```
## default
-`[]`
+```json
+[]
+```
# runtime.builtin
@@ -433,18 +723,47 @@ VSCode中启动语言服务时的[命令行参数](https://github.com/sumneko/lu
## type
-`object`
+
+```ts
+object<string, string>
+```
+
+## enum
+
+* `"default"`
+* `"enable"`
+* `"disable"`
+## default
+
+```json
+{
+ "basic": "default",
+ "bit": "default",
+ "bit32": "default",
+ "builtin": "default",
+ "coroutine": "default",
+ "debug": "default",
+ "ffi": "default",
+ "io": "default",
+ "jit": "default",
+ "math": "default",
+ "os": "default",
+ "package": "default",
+ "string": "default",
+ "table": "default",
+ "utf8": "default"
+}
+```
# runtime.fileEncoding
文件编码,`ansi` 选项只在 `Windows` 平台下有效。
## type
-`string`
-## default
-
-`"utf8"`
+```ts
+string
+```
## enum
@@ -452,28 +771,43 @@ VSCode中启动语言服务时的[命令行参数](https://github.com/sumneko/lu
* `"ansi"`
* `"utf16le"`
* `"utf16be"`
+## default
+
+```json
+"utf8"
+```
# runtime.meta
**Missing description!!**
## type
-`string`
+
+```ts
+string
+```
## default
-`"${version} ${language} ${encoding}"`
+```json
+"${version} ${language} ${encoding}"
+```
# runtime.nonstandardSymbol
支持非标准的符号。请务必确认你的运行环境支持这些符号。
## type
-`array<string>`
+
+```ts
+Array<string>
+```
## default
-`[]`
+```json
+[]
+```
# runtime.path
@@ -484,29 +818,48 @@ VSCode中启动语言服务时的[命令行参数](https://github.com/sumneko/lu
## type
-`array<string>`
+
+```ts
+Array<string>
+```
## default
-`[ "?.lua", "?/init.lua" ]`
+```json
+["?.lua","?/init.lua"]
+```
# runtime.pathStrict
启用后 `runtime.path` 将只搜索第一层目录,见 `runtime.path` 的说明。
## type
-`boolean`
+
+```ts
+boolean
+```
+
+## default
+
+```json
+false
+```
# runtime.plugin
插件路径,请查阅[文档](https://github.com/sumneko/lua-language-server/wiki/Plugin)了解用法。
## type
-`string`
+
+```ts
+string
+```
## default
-`""`
+```json
+""
+```
# runtime.special
@@ -520,29 +873,42 @@ VSCode中启动语言服务时的[命令行参数](https://github.com/sumneko/lu
## type
-`object`
+
+```ts
+Object<string, string>
+```
## default
-`{}`
+```json
+{}
+```
# runtime.unicodeName
允许在名字中使用 Unicode 字符。
## type
-`boolean`
+
+```ts
+boolean
+```
+
+## default
+
+```json
+false
+```
# runtime.version
Lua运行版本。
## type
-`string`
-
-## default
-`"Lua 5.4"`
+```ts
+string
+```
## enum
@@ -551,68 +917,107 @@ Lua运行版本。
* `"Lua 5.3"`
* `"Lua 5.4"`
* `"LuaJIT"`
+## default
+
+```json
+"Lua 5.4"
+```
# semantic.annotation
对类型注解进行语义着色。
## type
-`boolean`
+
+```ts
+boolean
+```
## default
-`true`
+```json
+true
+```
# semantic.enable
启用语义着色。你可能需要同时将 `editor.semanticHighlighting.enabled` 设置为 `true` 才能生效。
## type
-`boolean`
+
+```ts
+boolean
+```
## default
-`true`
+```json
+true
+```
# semantic.keyword
对关键字/字面量/运算符进行语义着色。只有当你的编辑器无法进行语法着色时才需要启用此功能。
## type
-`boolean`
+
+```ts
+boolean
+```
+
+## default
+
+```json
+false
+```
# semantic.variable
对变量/字段/参数进行语义着色。
## type
-`boolean`
+
+```ts
+boolean
+```
## default
-`true`
+```json
+true
+```
# signatureHelp.enable
启用参数提示。
## type
-`boolean`
+
+```ts
+boolean
+```
## default
-`true`
+```json
+true
+```
# spell.dict
**Missing description!!**
## type
-`array<string>`
+
+```ts
+Array<string>
+```
## default
-`[]`
+```json
+[]
+```
# telemetry.enable
@@ -620,33 +1025,48 @@ Lua运行版本。
## type
-`boolean | null`
+
+```ts
+boolean | null
+```
## default
-`nil`
+```json
+null
+```
# window.progressBar
在状态栏显示进度条。
## type
-`boolean`
+
+```ts
+boolean
+```
## default
-`true`
+```json
+true
+```
# window.statusBar
在状态栏显示插件状态。
## type
-`boolean`
+
+```ts
+boolean
+```
## default
-`true`
+```json
+true
+```
# workspace.checkThirdParty
@@ -661,96 +1081,141 @@ Lua运行版本。
## type
-`boolean`
+
+```ts
+boolean
+```
## default
-`true`
+```json
+true
+```
# workspace.ignoreDir
忽略的文件与目录(使用 `.gitignore` 语法)。
## type
-`array<string>`
+
+```ts
+Array<string>
+```
## default
-`[ ".vscode" ]`
+```json
+[".vscode"]
+```
# workspace.ignoreSubmodules
忽略子模块。
## type
-`boolean`
+
+```ts
+boolean
+```
## default
-`true`
+```json
+true
+```
# workspace.library
除了当前工作区以外,还会从哪些目录中加载文件。这些目录中的文件将被视作外部提供的代码库,部分操作(如重命名字段)不会修改这些文件。
## type
-`array<string>`
+
+```ts
+Array<string>
+```
## default
-`[]`
+```json
+[]
+```
# workspace.maxPreload
最大预加载文件数。
## type
-`integer`
+
+```ts
+integer
+```
## default
-`5000`
+```json
+5000
+```
# workspace.preloadFileSize
预加载时跳过大小大于该值(KB)的文件。
## type
-`integer`
+
+```ts
+integer
+```
## default
-`500`
+```json
+500
+```
# workspace.supportScheme
为以下 scheme 的lua文件提供语言服务。
## type
-`array<string>`
+
+```ts
+Array<string>
+```
## default
-`[ "file", "untitled", "git" ]`
+```json
+["file","untitled","git"]
+```
# workspace.useGitIgnore
忽略 `.gitignore` 中列举的文件。
## type
-`boolean`
+
+```ts
+boolean
+```
## default
-`true`
+```json
+true
+```
# workspace.userThirdParty
在这里添加私有的第三方库适配文件路径,请参考内置的[配置文件路径](https://github.com/sumneko/lua-language-server/tree/master/meta/3rd)
## type
-`array<string>`
+
+```ts
+Array<string>
+```
## default
-`[]` \ No newline at end of file
+```json
+[]
+``` \ No newline at end of file