From fbb48827806d456629d25c22097129078b53c9e6 Mon Sep 17 00:00:00 2001 From: yuetsh <517252939@qq.com> Date: Tue, 6 Jan 2026 22:29:12 +0800 Subject: [PATCH] update --- src/extensions/python.ts | 269 ++++++++++++++++++++++++++++++--------- 1 file changed, 206 insertions(+), 63 deletions(-) diff --git a/src/extensions/python.ts b/src/extensions/python.ts index 46bd6cc..7517dc0 100644 --- a/src/extensions/python.ts +++ b/src/extensions/python.ts @@ -3,7 +3,7 @@ export const python = [ label: "print", detail: "打印输出", type: "function", - info: "内置函数，将对象输出到标准输出，可用 sep 和 end 指定分隔符与结尾字符", + info: "最常用的输出函数，把内容打印到屏幕；sep 控制分隔符，end 控制行尾。", boost: 100, apply: "print()", }, @@ -11,7 +11,7 @@ export const python = [ label: "input", detail: "读取输入", type: "function", - info: "内置函数，读取一行输入并返回字符串，可传入提示信息", + info: "读取一行输入并返回字符串，可以传入提示文字。", boost: 95, apply: "input()", }, @@ -19,7 +19,7 @@ export const python = [ label: "len", detail: "获取长度", type: "function", - info: "返回对象的长度，常用于列表、字符串、字典等序列或集合类型", + info: "返回序列或集合的长度，常用来统计列表、字符串中有多少个元素。", boost: 90, apply: "len()", }, @@ -27,15 +27,15 @@ export const python = [ label: "range", detail: "生成整数序列", type: "function", - info: "返回不可变的整数序列，支持 start、stop、step，常用于 for 循环", + info: "生成整数序列，支持起点、终点和步长，常配合 for 循环遍历次数。", boost: 85, apply: "range()", }, { label: "enumerate", - detail: "枚举索引与元素", + detail: "枚举索引与值", type: "function", - info: "遍历可迭代对象时同时得到索引和值，可通过 start 指定起始索引", + info: "遍历时同时得到索引和值，可用 start 指定起始编号，适合需要编号输出的场景。", boost: 82, apply: "enumerate()", }, @@ -43,7 +43,7 @@ export const python = [ label: "zip", detail: "并行遍历", type: "function", - info: "将多个可迭代对象聚合为元组迭代器，长度以最短序列为准", + info: "把多个可迭代对象按位置打包成元组并行遍历，长度取最短的序列。", boost: 80, apply: "zip()", }, @@ -51,7 +51,7 @@ export const python = [ label: "map", detail: "映射函数", type: "function", - info: "对可迭代对象的每个元素应用函数，返回惰性迭代器", + info: "把函数作用到序列每个元素，返回惰性迭代器，需要 list() 展开后才能看到结果。", boost: 78, apply: "map()", }, @@ -59,7 +59,7 @@ export const python = [ label: "filter", detail: "过滤元素", type: "function", - info: "保留函数返回真值的元素，返回惰性迭代器", + info: "保留函数返回真值的元素，返回惰性迭代器，常用于筛选出符合条件的数据。", boost: 76, apply: "filter()", }, @@ -67,7 +67,7 @@ export const python = [ label: "sorted", detail: "排序", type: "function", - info: "返回排序后的新列表，支持 key 与 reverse 参数", + info: "返回排好序的新列表，支持 key 排序函数和 reverse 逆序，不会修改原序列。", boost: 74, apply: "sorted()", }, @@ -75,7 +75,7 @@ export const python = [ label: "sum", detail: "求和", type: "function", - info: "对可迭代对象元素求和，可指定起始值", + info: "对可迭代对象求和，可设置初始值，常用于数字累计与前缀和。", boost: 72, apply: "sum()", }, @@ -83,7 +83,7 @@ export const python = [ label: "open", detail: "文件读写", type: "function", - info: "打开文件并返回文件对象，常与 with 语句搭配确保自动关闭", + info: "打开文件获得文件对象，常配合 with 自动关闭，支持读写追加等多种模式。", boost: 70, apply: "open()", }, @@ -91,7 +91,7 @@ export const python = [ label: "abs", detail: "绝对值", type: "function", - info: "返回数字的绝对值", + info: "返回数字的绝对值，把负数变成正数，常用于距离或差值计算。", boost: 68, apply: "abs()", }, @@ -99,7 +99,7 @@ export const python = [ label: "round", detail: "四舍五入", type: "function", - info: "按指定精度进行四舍五入，默认到整数", + info: "按指定小数位四舍五入，默认保留到整数，适合处理成绩或金额保留位数。", boost: 66, apply: "round()", }, @@ -107,7 +107,7 @@ export const python = [ label: "isinstance", detail: "类型检查", type: "function", - info: "判断对象是否为某个类型或类型元组的实例", + info: "判断对象是否属于某个类型或类型元组，常用于分支处理不同数据。", boost: 64, apply: "isinstance()", }, @@ -115,7 +115,7 @@ export const python = [ label: "type", detail: "获取类型", type: "function", - info: "返回对象的类型，或在三个参数形式下动态创建类型", + info: "返回对象的类型，或用三个参数动态创建类型，用来了解变量真实类型。", boost: 62, apply: "type()", }, @@ -123,7 +123,7 @@ export const python = [ label: "list", detail: "列表构造", type: "function", - info: "将可迭代对象转换为列表，或创建空列表", + info: "把可迭代对象转换为列表，或创建空列表存放数据，支持列表推导式。", boost: 60, apply: "list()", }, @@ -131,7 +131,7 @@ export const python = [ label: "dict", detail: "字典构造", type: "function", - info: "根据映射或键值对序列创建字典", + info: "根据映射或键值对序列创建字典，用来存储键值对信息。", boost: 58, apply: "dict()", }, @@ -139,7 +139,7 @@ export const python = [ label: "set", detail: "集合构造", type: "function", - info: "根据可迭代对象创建集合，自动去重", + info: "把可迭代对象转换为集合，自动去重，适合判重和集合运算。", boost: 56, apply: "set()", }, @@ -147,7 +147,7 @@ export const python = [ label: "tuple", detail: "元组构造", type: "function", - info: "将可迭代对象转换为元组，或创建空元组", + info: "把可迭代对象转换为元组，或创建不可变的序列，用作安全的组合数据。", boost: 54, apply: "tuple()", }, @@ -155,7 +155,7 @@ export const python = [ label: "int", detail: "转整数", type: "function", - info: "将参数转换为整型，支持基数转换", + info: "把参数转为整数，支持进制转换，如 int('101', 2) 表示二进制转十进制。", boost: 74, apply: "int()", }, @@ -163,7 +163,7 @@ export const python = [ label: "float", detail: "转浮点数", type: "function", - info: "将参数转换为浮点数，支持字符串与数字", + info: "把参数转为浮点数，接受字符串或数字，常用于保留小数的计算。", boost: 72, apply: "float()", }, @@ -171,7 +171,7 @@ export const python = [ label: "str", detail: "转字符串", type: "function", - info: "将对象转换为字符串表示，常用于输出", + info: "把对象转为字符串，常用于输出、拼接或写入文件。", boost: 70, apply: "str()", }, @@ -179,7 +179,7 @@ export const python = [ label: "bool", detail: "转布尔值", type: "function", - info: "根据真值测试转换为 True/False，空对象为 False", + info: "按真值规则转为 True/False，空对象一般为 False，常用于条件判断。", boost: 68, apply: "bool()", }, @@ -187,70 +187,213 @@ export const python = [ label: "def", detail: "定义函数", type: "keyword", - info: "定义可复用的函数块，支持位置参数、关键字参数与默认值", + info: "定义函数，可写位置参数、关键字参数和默认值，是封装和复用代码的基础。", boost: 52, }, { label: "class", detail: "定义类", type: "keyword", - info: "定义自定义类型，支持继承与魔术方法", + info: "定义类，支持继承和魔术方法，用来创建自定义数据类型。", boost: 50, }, { label: "with", detail: "上下文管理", type: "keyword", - info: "进入上下文管理器，自动处理资源的进入与退出", + info: "进入上下文管理器，自动处理进入与退出，常用于文件、锁等需要收尾的资源。", boost: 48, }, { label: "try", detail: "异常捕获", type: "keyword", - info: "开始异常处理块，与 except/finally/else 结合使用", + info: "开始异常处理代码块，后面接 except/finally/else，防止程序因错误直接退出。", boost: 46, }, { label: "except", detail: "处理异常", type: "keyword", - info: "捕获特定异常类型并处理，常配合 try 使用", + info: "捕获并处理指定异常，与 try 连用，让程序能优雅处理输入或运行时错误。", boost: 44, }, { label: "finally", - detail: "清理收尾", + detail: "收尾", type: "keyword", - info: "无论是否发生异常都执行的收尾代码块", + info: "无论是否出现异常都会执行的收尾代码块，常用于关闭文件或释放资源。", boost: 42, }, { label: "import", detail: "导入模块", type: "keyword", - info: "导入模块或包中的名称，可与 as 指定别名", + info: "导入模块或包中的名称，可用 as 取别名，便于使用标准库或第三方库。", boost: 40, }, { label: "from", detail: "按需导入", type: "keyword", - info: "从模块中按名称导入对象，可结合 import 与 as", + info: "从模块中按名称导入对象，可与 import/as 组合，减少书写模块前缀。", boost: 38, }, { label: "return", detail: "返回值", type: "keyword", - info: "结束函数并返回值，未指定值时返回 None", + info: "结束函数并返回一个值，不写时默认返回 None。", boost: 36, }, + { + label: "for", + detail: "for 循环", + type: "keyword", + info: "for target in iterable 结构，逐项遍历，可配合 else、enumerate、zip 等使用。", + boost: 45, + }, + { + label: "while", + detail: "while 循环", + type: "keyword", + info: "条件循环，条件为真时执行，支持 break/continue 和 else 分支。", + boost: 43, + }, + { + label: "if", + detail: "条件分支", + type: "keyword", + info: "if 判断，条件成立执行对应语句，可与 elif/else 组成多分支。", + boost: 41, + apply: "if ", + }, + { + label: "elif", + detail: "多分支判断", + type: "keyword", + info: "否则如果，用来依次判断多个条件，让逻辑更清晰。", + boost: 39, + apply: "elif ", + }, + { + label: "else", + detail: "否则", + type: "keyword", + info: "否则，在前面条件不满足或循环未提前退出时执行。", + boost: 37, + apply: "else:", + }, + { + label: "break", + detail: "退出循环", + type: "keyword", + info: "立即终止最近的循环（for 或 while），跳出当前循环体。", + boost: 35, + }, + { + label: "continue", + detail: "跳过本次", + type: "keyword", + info: "结束本轮循环迭代，直接开始下一轮条件判断。", + boost: 33, + }, + { + label: "pass", + detail: "空操作占位", + type: "keyword", + info: "占位语句，不执行任何操作，常用于占位或编写空的函数/类体。", + boost: 31, + }, + { + label: "lambda", + detail: "匿名函数", + type: "keyword", + info: "定义轻量级匿名函数，语法 lambda 参数: 表达式，返回表达式结果，适合简短逻辑。", + boost: 29, + }, + { + label: "yield", + detail: "生成器产出", + type: "keyword", + info: "在函数中产出一个值并暂停状态，把函数变成生成器，可配合 yield from 继续产出。", + boost: 27, + }, + { + label: "global", + detail: "声明全局变量", + type: "keyword", + info: "在函数内部声明写入模块级变量的权限，用于修改外层的全局变量。", + boost: 25, + }, + { + label: "nonlocal", + detail: "声明外层变量", + type: "keyword", + info: "在嵌套函数中声明使用最近外层作用域的变量，便于修改闭包变量。", + boost: 23, + }, + { + label: "True", + detail: "布尔真", + type: "keyword", + info: "布尔常量 True，与 False/None 一起常用于条件表达式和逻辑判断。", + boost: 21, + }, + { + label: "False", + detail: "布尔假", + type: "keyword", + info: "布尔常量 False，在逻辑判断中表示假值，常作为条件的否定结果。", + boost: 19, + }, + { + label: "None", + detail: "空值对象", + type: "keyword", + info: "表示空值或缺失值的单例对象，常用于默认参数或占位。", + boost: 17, + }, + { + label: "and", + detail: "逻辑与", + type: "keyword", + info: "逻辑与运算符，短路求值，返回最后被求值的操作数，常用于多条件同时成立。", + boost: 15, + }, + { + label: "or", + detail: "逻辑或", + type: "keyword", + info: "逻辑或运算符，短路求值，返回第一个真值或最后一个操作数，常用于设默认值。", + boost: 14, + }, + { + label: "not", + detail: "逻辑非", + type: "keyword", + info: "逻辑非运算符，返回布尔取反结果，把真变假、假变真。", + boost: 13, + }, + { + label: "in", + detail: "成员测试", + type: "keyword", + info: "判断元素是否在序列、集合或字典中，返回布尔结果，常用于查找。", + boost: 12, + }, + { + label: "is", + detail: "身份比较", + type: "keyword", + info: "比较两个对象是否是同一个对象，常用于和 None 比较以避免误判。", + boost: 11, + }, { label: "append", detail: "列表追加", type: "method", - info: "在列表尾部添加新元素，等价于 list.append(value)", + info: "在列表尾部添加一个新元素，等价于 list.append(value)。", boost: 48, apply: "append()", }, @@ -258,7 +401,7 @@ export const python = [ label: "insert", detail: "列表插入", type: "method", - info: "在指定位置插入元素，list.insert(index, value)", + info: "在指定位置插入元素，语法 list.insert(index, value)。", boost: 46, apply: "insert()", }, @@ -266,7 +409,7 @@ export const python = [ label: "remove", detail: "删除匹配值", type: "method", - info: "删除列表中第一次出现的指定值，若不存在将抛出异常", + info: "删除列表中第一次出现的指定值，不存在会抛出异常 ValueError。", boost: 44, apply: "remove()", }, @@ -274,7 +417,7 @@ export const python = [ label: "pop", detail: "弹出元素", type: "method", - info: "移除并返回列表指定位置（默认尾部）的元素", + info: "移除并返回列表指定位置（默认尾部）的元素，用于栈或队列操作。", boost: 42, apply: "pop()", }, @@ -282,7 +425,7 @@ export const python = [ label: "count", detail: "统计次数", type: "method", - info: "返回某个对象在列表中出现的次数", + info: "返回某个对象在列表中出现的次数，常用于频次统计。", boost: 40, apply: "count()", }, @@ -290,7 +433,7 @@ export const python = [ label: "reverse", detail: "反转列表", type: "method", - info: "原地反转列表中元素的顺序", + info: "原地反转列表中元素的顺序，常与切片 [::-1] 效果类似。", boost: 38, apply: "reverse()", }, @@ -298,7 +441,7 @@ export const python = [ label: "sort", detail: "列表排序", type: "method", - info: "对列表进行原地排序，可指定 key 与 reverse", + info: "对列表进行原地排序，可指定 key 排序函数和 reverse 是否倒序。", boost: 36, apply: "sort()", }, @@ -306,7 +449,7 @@ export const python = [ label: "add", detail: "集合添加", type: "method", - info: "向集合添加单个元素，若已存在则忽略", + info: "向集合添加单个元素，若元素已存在则忽略，保持集合去重特性。", boost: 50, apply: "add()", }, @@ -314,7 +457,7 @@ export const python = [ label: "clear", detail: "清空集合", type: "method", - info: "移除集合中所有元素，变为空集", + info: "移除集合中所有元素，变成一个空集合。", boost: 48, apply: "clear()", }, @@ -322,7 +465,7 @@ export const python = [ label: "keys", detail: "字典键", type: "method", - info: "返回字典键的可迭代视图", + info: "返回字典键的可迭代视图，用于遍历所有键。", boost: 42, apply: "keys()", }, @@ -330,15 +473,15 @@ export const python = [ label: "values", detail: "字典值", type: "method", - info: "返回字典值的可迭代视图", + info: "返回字典值的可迭代视图，用于遍历所有值。", boost: 40, apply: "values()", }, { label: "split", - detail: "字符串切割", + detail: "字符串切分", type: "method", - info: "按分隔符切分字符串，返回列表，默认按空白字符", + info: "按分隔符切分字符串，返回列表，默认按空白字符分割。", boost: 52, apply: "split()", }, @@ -346,7 +489,7 @@ export const python = [ label: "replace", detail: "字符串替换", type: "method", - info: "将字符串中的子串替换为新内容，可限定次数", + info: "把字符串中的子串替换为新内容，可限制替换次数。", boost: 50, apply: "replace()", }, @@ -354,15 +497,15 @@ export const python = [ label: "format", detail: "格式化字符串", type: "method", - info: "使用占位符或命名参数进行字符串格式化", + info: "使用占位符或命名参数进行字符串格式化，便于拼接变量输出。", boost: 48, apply: "format()", }, { label: "strip", - detail: "去首尾指定字符", + detail: "去首尾字符", type: "method", - info: "移除字符串首尾指定字符，默认移除空白", + info: "移除字符串首尾指定字符，默认移除空白符，常用于清理输入。", boost: 46, apply: "strip()", }, @@ -370,7 +513,7 @@ export const python = [ label: "lower", detail: "转小写", type: "method", - info: "将字符串中的字母转换为小写形式", + info: "把字符串中的字母转换为小写形式，常用于不区分大小写比较。", boost: 44, apply: "lower()", }, @@ -378,7 +521,7 @@ export const python = [ label: "upper", detail: "转大写", type: "method", - info: "将字符串中的字母转换为大写形式", + info: "把字符串中的字母转换为大写形式。", boost: 42, apply: "upper()", }, @@ -386,7 +529,7 @@ export const python = [ label: "swapcase", detail: "大小写互换", type: "method", - info: "将字符串中的大小写字母互换", + info: "把字符串中的大小写字母互换，便于切换展示风格。", boost: 40, apply: "swapcase()", }, @@ -394,7 +537,7 @@ export const python = [ label: "find", detail: "查找子串位置", type: "method", - info: "返回子串首次出现的索引，未找到返回 -1", + info: "返回子串首次出现的索引，未找到返回 -1，适合安全查找。", boost: 38, apply: "find()", }, @@ -402,7 +545,7 @@ export const python = [ label: "index", detail: "查找子串索引", type: "method", - info: "返回子串首次出现的索引，未找到抛出异常", + info: "返回子串首次出现的索引，未找到会抛出异常 ValueError。", boost: 36, apply: "index()", }, @@ -410,7 +553,7 @@ export const python = [ label: "startswith", detail: "前缀判断", type: "method", - info: "判断字符串是否以指定前缀开头，可指定范围", + info: "判断字符串是否以指定前缀开头，可指定检查的范围切片。", boost: 34, apply: "startswith()", }, @@ -418,7 +561,7 @@ export const python = [ label: "endswith", detail: "后缀判断", type: "method", - info: "判断字符串是否以指定后缀结尾，可指定范围", + info: "判断字符串是否以指定后缀结尾，可指定范围，常用于文件名处理。", boost: 32, apply: "endswith()", }, @@ -426,7 +569,7 @@ export const python = [ label: "isalnum", detail: "是否字母数字", type: "method", - info: "检测字符串是否只由字母和数字组成", + info: "检测字符串是否只由字母和数字组成，常用于基础输入校验。", boost: 30, apply: "isalnum()", }, @@ -434,7 +577,7 @@ export const python = [ label: "isalpha", detail: "是否字母", type: "method", - info: "检测字符串是否只由字母组成", + info: "检测字符串是否只由字母组成，用来判断名字等只含字母的场景。", boost: 28, apply: "isalpha()", }, @@ -442,7 +585,7 @@ export const python = [ label: "isdigit", detail: "是否数字", type: "method", - info: "检测字符串是否只由数字组成", + info: "检测字符串是否只由数字组成，用来判断输入是否为纯数字。", boost: 26, apply: "isdigit()", }, @@ -450,7 +593,7 @@ export const python = [ label: "islower", detail: "是否全小写", type: "method", - info: "检测字符串是否全部由小写字母组成且至少有一个字母", + info: "检测字符串是否全部由小写字母组成且至少有一个字母。", boost: 24, apply: "islower()", }, @@ -458,7 +601,7 @@ export const python = [ label: "isupper", detail: "是否全大写", type: "method", - info: "检测字符串中所有字母是否都为大写且至少有一个字母", + info: "检测字符串中所有字母是否都是大写且至少有一个字母。", boost: 22, apply: "isupper()", },