Skip to content
| Marketplace
Sign in
Visual Studio Code>Programming Languages>古叶脚本助手New to Visual Studio Code? Get it now.
古叶脚本助手

古叶脚本助手

古叶脚本助手

|
52 installs
| (1) | Free
古叶脚本编辑工具:语法高亮、智能提示、诊断、格式化与标记导航。
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

古叶脚本助手

古叶脚本助手是一款面向古叶脚本编写者的 VS Code 扩展,提供语法高亮、命令补全、参数提示、错误检查、格式化、标记与变量导航、自定义代码块,以及不连接游戏的“逻辑试运行”。

这份文档按第一次接触 VS Code 和古叶脚本的使用流程编写。建议新手从“安装扩展”开始依次操作;已经使用过旧版本的用户可以直接阅读“升级扩展与配置更新”和“逻辑试运行”。

当前版本:1.11.7

扩展能做什么

  • 将项目中的 .txt 文件识别为古叶脚本并进行语法高亮。
  • 输入命令时提供搜索、补全、参数说明、示例和悬停帮助。
  • 检查未知命令、参数数量、必填空值、枚举值、标记和变量。
  • 自动格式化缩进,并可在补全启动类命令时插入对应的关闭命令。
  • 支持跳转到标记或变量定义、查找引用以及重命名。
  • 将常用的多行脚本保存为当前项目专用的代码块。
  • 使用可注入的测试数据试运行脚本逻辑,查看执行轨迹和覆盖情况。

逻辑试运行只分析脚本控制流,不会连接游戏,也不会真正执行移动、打怪、购买、传送等游戏命令。

一、安装扩展

古叶脚本助手已经上线 VS Code 扩展商店,可直接在 VS Code 中搜索并安装。

  1. 打开 VS Code。
  2. 点击左侧活动栏中的“扩展”图标,或按 Ctrl+Shift+X;macOS 使用 Cmd+Shift+X。
  3. 在搜索框中输入“古叶脚本助手”。
  4. 找到扩展后,确认扩展标识为 guye-script-assistant.guye-script-assistant。
  5. 点击“安装”。
  6. 如果 VS Code 提示重新加载窗口,点击“重新加载”。

也可以直接打开古叶脚本助手的扩展商店页面。如果按中文名称没有找到,可在扩展搜索框中输入:

@id:guye-script-assistant.guye-script-assistant

二、第一次打开脚本项目

不要只双击打开一个 .txt 文件。推荐先建立一个专门存放脚本的文件夹,再用 VS Code 打开整个文件夹,这样扩展才能创建项目配置、自定义代码块和每个脚本独立的测试数据。

  1. 在电脑上建立项目文件夹,例如 古叶脚本项目。
  2. 将脚本放入该文件夹,允许继续使用 脚本/日常/押镖.txt 这样的多级目录。
  3. 在 VS Code 中选择“文件 → 打开文件夹…”。
  4. 选择刚才建立的项目文件夹。
  5. 按 Ctrl+Shift+P;macOS 使用 Cmd+Shift+P。
  6. 输入并执行“古叶脚本: 初始化当前项目配置”。

初始化完成后,项目中会出现或更新:

项目根目录/
├── .vscode/
│   ├── settings.json
│   └── guye-script.test.json
└── 脚本/
    └── 示例.txt

其中:

  • .vscode/settings.json 是当前项目的 VS Code 设置。
  • .vscode/guye-script.test.json 是逻辑试运行的初始测试数据模板。
  • 首次试运行某个脚本时,还会自动生成该脚本自己的测试数据文件。

初始化会加入哪些设置

扩展会合并配置,不会清空 settings.json 中与古叶脚本无关的内容。主要配置包括:

{
    "files.associations": {
        "*.txt": "guye-script"
    },
    "files.encoding": "utf8",
    "files.autoGuessEncoding": true,
    "editor.mouseWheelZoom": true,
    "[guye-script]": {
        "editor.insertSpaces": true,
        "editor.tabSize": 4,
        "editor.detectIndentation": false,
        "editor.autoIndent": "full",
        "editor.defaultFormatter": "guye-script-assistant.guye-script-assistant",
        "editor.formatOnSave": true,
        "editor.wordWrap": "on"
    }
}

files.autoGuessEncoding 和 editor.mouseWheelZoom 是工作区通用设置;editor.wordWrap、缩进和格式化器只对 [guye-script] 生效。初始化还会合并标记颜色规则,以便区分标记定义和引用。

如果项目已有这些配置,扩展会尽量保留用户值,只补齐缺少的配置并迁移旧版格式化器 ID。

三、确认文件已被识别为古叶脚本

打开任意脚本 .txt 文件后,观察 VS Code 窗口右下角的语言模式:

  • 显示“古叶脚本”:识别成功。
  • 显示“纯文本”:点击“纯文本”,搜索并选择“古叶脚本”。

如果每次打开都回到纯文本,请重新执行初始化,并检查 .vscode/settings.json 中是否存在:

{
    "files.associations": {
        "*.txt": "guye-script"
    }
}

四、先认识古叶脚本的基本写法

1. 命令和参数

一行通常由“命令名称”和若干参数组成,参数之间使用 / 分隔:

等待/3
移动到坐标/1655.78/732.282/221.281/100/3
购买物品/780/2/1000

不同命令需要的参数数量不同。部分命令允许省略尾部可选参数,例如:

移动到坐标/1655.78/732.282/221.281
移动到高度/37.5
购买物品/780/2/1000
等待队员到齐/30
传送至/沐火村
传送至/城西/追电传送石
传送至/城西/

上面的规则分别表示:

  • 移动到坐标 的第 4、5 个参数可选。
  • 移动到高度 的第 2 个参数可选。
  • 购买物品 最多 4 个参数,第 4 个“模式”可选。
  • 等待队员到齐 的第 2 个参数可以省略或留空。
  • 传送至 的第 2 个参数是传送石名称,可以省略或留空。

输入命令后继续输入 /,编辑器会显示当前参数位置和说明。不要凭记忆补齐无意义的空参数,以扩展显示的参数帮助为准。

2. 注释

只有一行在忽略前导空格后以 // 或 -- 开头时,整行才会被识别为注释:

// 这是一行注释
-- 这也是一行注释
    // 前面有空格也仍是整行注释

命令或参数中间出现 //、-- 不会自动把后半行标记为注释,因此不要使用行尾注释:

等待/3 // 不要这样写行尾说明

3. 标记与跳转

标记使用一对方括号定义,跳转命令中只填写标记名称,不需要再写方括号:

[开始]
等待/1
标记跳转/结束

[结束]
停止脚本

标记名称应清楚、唯一。扩展会检查重复标记、找不到的标记和未被引用的标记。

4. 变量与内置取值

用 设置变量 创建或赋值变量:

设置变量/计次/0
变量运算/计次/加/1

在普通参数中引用变量时使用 #变量名#:

判断跳转/#计次#/等于/3/结束

依赖游戏状态的内置取值使用尖括号,例如:

判断跳转/<自身等级>/大于/100/高等级

变量和内置取值在真正运行游戏脚本时由脚本环境提供;在 VS Code 的逻辑试运行中,需要使用测试数据注入预期值。

5. 一个适合练习的完整脚本

新建 练习.txt,输入:

// 练习变量、任务判断和标记跳转
设置变量/计次/0

[检查任务]
任务跳转/25671/存在/任务25671
标记跳转/没有任务

[任务25671]
变量运算/计次/加/1
判断跳转/#计次#/等于/3/结束
标记跳转/检查任务

[没有任务]
停止脚本

[结束]
停止脚本

保存文件后,可以先观察有无红色或黄色波浪线,再使用后文的逻辑试运行验证两条分支。

五、智能补全和命令帮助

输入命令

在空白行输入命令名称的一部分,扩展会按前缀、包含关系和模糊匹配给出候选项。例如输入“坐标”可以找到与坐标有关的命令。

选中候选项后:

  • 命令和参数占位会自动插入。
  • 按 Tab 在参数之间移动。
  • 输入 / 后会显示当前参数说明。
  • 候选项详情中可查看用途和示例。

当补全列表出现时,可用 Ctrl+Shift+I 切换详情;macOS 使用 Cmd+Shift+I。

自动插入成对命令

补全部分“启动…”命令时,扩展会自动插入对应的“关闭…”命令,并将光标留在中间。可通过设置 guyeScript.pairedCommands.enabled 关闭该行为。

光标悬停帮助

把鼠标或文本光标停在命令名称上,扩展会自动显示参数、用途和示例。默认延迟是 350 毫秒,可在设置中修改或关闭。

六、错误检查与快速修复

扩展会在编辑过程中检查:

  • 命令名称是否存在。
  • 参数数量是否正确。
  • 必填参数是否为空。
  • 明确规定的枚举值是否有效。
  • 静态跳转目标是否存在。
  • 标记是否重复或未使用。
  • #变量# 或变量名称参数是否在脚本中定义。

将鼠标移到波浪线上可查看原因。打开“问题”面板可以集中查看全部错误:

  • Windows/Linux:Ctrl+Shift+M
  • macOS:Cmd+Shift+M

对于缺失的静态标记,可以把光标放在诊断位置,按 Ctrl+.;macOS 使用 Cmd+.,选择快速修复来创建对应标记。

动态拼接的标记可能无法完全通过静态分析。如果脚本确实依赖运行时变量生成标记,请同时使用逻辑试运行验证,并确认测试数据包含需要的变量。

七、格式化脚本

初始化后默认开启保存时格式化。也可以手动执行:

  • Windows/Linux:Shift+Alt+F
  • macOS:Shift+Option+F
  • 或在命令面板中执行“格式化文档”。

格式化器会根据成对的启动和关闭命令整理缩进,让标记保持在行首,并保留注释和必要的空行。如果没有格式化,请先确认右下角语言模式为“古叶脚本”,再执行“使用…格式化文档”并选择“古叶脚本助手”。

八、跳转、查找引用与重命名

扩展支持标记和变量的代码导航:

  • F12:跳转到定义。
  • Ctrl+单击:Windows/Linux 跳转到定义。
  • Cmd+单击:macOS 跳转到定义。
  • Shift+F12:查找全部引用。
  • F2:重命名当前标记或变量。

重命名会同步修改扩展能够识别的定义和引用。修改后仍应查看“问题”面板,避免动态拼接文本中保留旧名称。

扩展也会解析动态标记模板和“聊天信息批量跳转”等命令中的跳转目标,但复杂运行时拼接仍可能需要人工检查。

九、把常用脚本保存为代码块

如果经常重复输入一组命令,可以将其保存为当前项目的补全代码块:

  1. 在古叶脚本文件中选中一段完整内容。
  2. 右键选择“古叶脚本:保存所选内容为代码块”,或从命令面板执行同名命令。
  3. 输入代码块名称,例如“移动并打怪”。
  4. 输入补全触发词,例如“移动打怪”。
  5. 输入说明;说明允许留空。
  6. 保存后,在古叶脚本中输入触发词并选择补全项。

代码块保存在:

.vscode/guye-script.code-snippets

它只属于当前项目,适合把不同项目的常用写法分开管理。若代码块名称已经存在,扩展会询问是否覆盖。

十、逻辑试运行:不连接游戏先检查流程

逻辑试运行适合发现死循环、错误跳转、遗漏分支和测试数据不足。它不会替代游戏内实测,但可以在编辑阶段快速验证控制逻辑。

启动试运行

  1. 打开要测试的古叶脚本。
  2. 点击编辑器右上角的播放按钮 ▶,或执行命令“古叶脚本: 逻辑试运行当前脚本”。
  3. 如果存在多个测试场景,选择“基础数据”或某个场景。
  4. 查看“输出”面板中的“古叶脚本 · 逻辑试运行”频道。

运行中可点击停止按钮,或执行“古叶脚本: 停止逻辑试运行”。

如果静态检查已经发现错误,扩展默认取消运行;只有明确选择“忽略错误并继续”才会跳过未知命令继续测试。

能模拟的内容

试运行会处理:

  • 设置变量、清空变量 和数值 变量运算。
  • 判断跳转。
  • 依赖测试数据的各种 …跳转。
  • 标记跳转、无条件跳转 和相对跳转。
  • 随机跳转。
  • 标记调用 与 标记返回。
  • 停止脚本。

移动、打怪、传送、购买和等待等游戏命令只记录,不会真正执行。没有注入数据的游戏条件默认按“不跳转”继续,并在结果中报告缺少的注入项。

如何阅读输出

输出面板会显示:

  • 每一步执行的行号、命令和处理结果。
  • 跳转到了哪个标记,或为什么没有跳转。
  • 最终停止原因和执行步数。
  • 最终变量值。
  • 命令覆盖率和条件分支覆盖率。
  • 未执行标记。
  • 缺少的变量、内置取值、任务状态和条件注入。
  • 测试数据中存在但本次没有使用的键。

默认最多执行 500 个命令步骤,用来阻止疑似死循环;默认最多保留 5000 行轨迹。两项限制都可以在设置中修改。

十一、每个脚本独立的测试数据

初始化时创建的是公共初始模板:

.vscode/guye-script.test.json

第一次试运行当前脚本时,扩展会根据脚本相对路径自动创建独立文件。例如:

脚本文件:脚本/日常/押镖.txt
测试数据:.vscode/guye-script.test/脚本/日常/押镖.txt.json

另一个脚本:

脚本文件:脚本/副本/押镖.txt
测试数据:.vscode/guye-script.test/脚本/副本/押镖.txt.json

即使两个文件同名,只要目录不同,测试数据也不会冲突。

生成规则如下:

  1. 每个脚本第一次生成独立文件时,以公共初始模板为基础。
  2. 扩展扫描当前脚本需要的变量、内置取值、任务、游戏条件和随机跳转。
  3. 缺少的键会自动补入独立文件,并使用安全的占位值。
  4. 已经人工修改的值不会被覆盖。
  5. 脚本删除了某个引用后,旧测试键不会自动删除,便于保留测试数据;运行结果会提示未使用项。
  6. 后续试运行只读取当前脚本的独立文件,不会反复把公共模板覆盖进去。

如果修改 guyeScript.dryRun.testDataFile 为 test-data/default.json,独立数据目录会变成:

test-data/default/<脚本相对路径>.json

十二、测试数据文件格式详解

测试数据必须是标准 JSON:键名和字符串必须使用双引号,不能写注释,也不能在最后一项后保留逗号。

默认结构:

{
    "variables": {},
    "values": {},
    "tasks": {},
    "conditions": {},
    "random": {},
    "scenarios": {}
}

还可以在根对象中加入 randomSeed。

1. variables:注入脚本变量

variables 用于给脚本开始时尚未由 设置变量 创建的变量提供初始值。键名不写 #:

{
    "variables": {
        "任务ID": 25671,
        "X比对值": 5,
        "角色名": "古叶测试角色",
        "允许继续": true
    }
}

允许的值类型是数字、字符串和布尔值。脚本中的 #任务ID# 会读取这里的 任务ID。

如果脚本稍后执行 设置变量/任务ID/100,运行时变量会更新为脚本设置的新值。

2. values:注入游戏内置取值

values 用于模拟 <自身等级>、<当前地图ID> 等依赖游戏的数据。键名不写尖括号:

{
    "values": {
        "自身等级": 105,
        "当前地图ID": 1903,
        "角色职业": "武侠"
    }
}

脚本中的 <自身等级> 会被替换为 105。允许数字、字符串和布尔值。

3. tasks:注入任务状态

tasks 用于测试 任务跳转。最简单的写法:

{
    "tasks": {
        "25671": "存在",
        "50018": "完成",
        "50019": "未完成",
        "50020": "不存在"
    }
}

例如脚本:

任务跳转/25671/存在/任务25671

当 tasks.25671 是 "存在" 时会跳转到 [任务25671];设为 "不存在" 时不会跳转。

任务状态支持以下格式:

{
    "tasks": {
        "25671": "存在",
        "25672": true,
        "25673": {
            "status": "未完成"
        },
        "25674": {
            "exists": true,
            "completed": false
        }
    }
}

字符串状态只能使用 存在、不存在、完成、未完成。对象格式适合同时表达任务是否存在和是否完成。

4. conditions:注入依赖游戏的跳转结果

除 判断跳转、任务跳转 和普通标记跳转外,许多 …跳转 命令需要读取游戏数据。这些命令使用 conditions 注入结果。

假设脚本为:

任务杀怪数量跳转/#任务ID#/大于/#X比对值#/Y加1

可以这样测试条件成立:

{
    "variables": {
        "任务ID": 25671,
        "X比对值": 5
    },
    "conditions": {
        "任务杀怪数量跳转/#任务ID#/大于/#X比对值#": true
    }
}

这里的条件键保留脚本中的变量写法,但省略命令自带的固定跳转目标 /Y加1。设为 true 时跳转到 [Y加1],设为 false 时继续下一行。

条件值支持四类写法:

{
    "conditions": {
        "条件A": true,
        "条件B": false,
        "条件C": "另一个标记",
        "条件D": [false, true, "备用标记"],
        "条件E": {
            "jump": true,
            "target": "指定标记"
        }
    }
}
  • true:条件成立,使用命令本身的固定跳转目标。
  • false:条件不成立,继续下一行。
  • 字符串或整数:条件成立,并把该值作为本次跳转目标。
  • 数组:同一个条件多次执行时按顺序取值;超过数组长度后继续使用最后一个值。
  • { "jump": true, "target": "标记" }:显式指定是否跳转及目标。

像 范围任务名跳转 这样没有固定目标参数的命令,不能只写 true,必须注入具体目标:

{
    "conditions": {
        "范围任务名跳转/开始任务/结束任务": "找到任务"
    }
}

不确定条件键怎么写时,先启动一次逻辑试运行。扩展会在当前脚本的独立测试文件中自动补出正确的键,也会在输出中列出缺少的条件注入。

5. random:控制随机跳转

random 用于让 随机跳转 在测试中得到可重复的结果。值可以是候选标记名称、从 1 开始的候选序号,或按调用次数取值的数组:

{
    "random": {
        "随机跳转/路线A|路线B|路线C": 2,
        "随机跳转/入口A|入口B": [1, 2, "入口A"]
    }
}

如果不想逐条指定,可以设置随机种子:

{
    "randomSeed": 20260818
}

相同脚本、相同测试数据和相同种子会产生可重复的随机选择,便于对比修改前后的执行轨迹。

6. scenarios:同一脚本保存多组测试场景

scenarios 可以为同一脚本保存多组覆盖数据。场景中的字段会覆盖根级基础数据,没有写到场景中的键继续使用基础值。

{
    "variables": {
        "任务ID": 25671,
        "X比对值": 5
    },
    "values": {
        "自身等级": 100
    },
    "tasks": {
        "25671": "存在"
    },
    "conditions": {},
    "random": {},
    "randomSeed": 100,
    "scenarios": {
        "任务存在且数量达标": {
            "tasks": {
                "25671": "存在"
            },
            "conditions": {
                "任务杀怪数量跳转/#任务ID#/大于/#X比对值#": true
            }
        },
        "任务不存在": {
            "tasks": {
                "25671": "不存在"
            }
        },
        "低等级角色": {
            "values": {
                "自身等级": 20
            },
            "randomSeed": 200
        }
    }
}

启动逻辑试运行时,扩展会让你选择“基础数据”或一个场景。建议至少为关键判断建立“成立”和“不成立”两组场景,再比较分支覆盖率。

十三、推荐的新手测试流程

以这行脚本为例:

任务跳转/25671/存在/任务25671

推荐操作:

  1. 先保存脚本并处理“问题”面板中的静态错误。
  2. 启动一次逻辑试运行,让扩展生成当前脚本独立的 JSON。
  3. 在输出中找到测试数据路径并打开该文件。
  4. 将自动生成的任务值改为 "存在"。
  5. 再次运行,确认执行轨迹到达 [任务25671]。
  6. 将任务值改为 "不存在",或建立第二个场景。
  7. 再次运行,确认“不成立”分支也符合预期。
  8. 查看未执行标记和分支覆盖率,继续补充场景。

对所有依赖游戏的数据都采用同样思路:变量放入 variables,尖括号取值放入 values,任务状态放入 tasks,其他游戏判断放入 conditions,随机选择放入 random。

十四、扩展设置

打开 VS Code 设置,搜索 guyeScript 即可修改。也可以在 .vscode/settings.json 中直接填写。

设置 默认值 作用
guyeScript.diagnostics.enabled true 启用未知命令、参数、标记和变量诊断
guyeScript.diagnostics.unusedLabels true 提示未被静态或动态引用的标记
guyeScript.diagnostics.parameters true 检查参数数量、空值和明确的枚举值
guyeScript.diagnostics.variables true 检查变量是否已经定义
guyeScript.cursorHover.enabled true 光标停留时自动显示命令帮助
guyeScript.cursorHover.delay 350 自动帮助延迟,单位毫秒,范围 100~3000
guyeScript.pairedCommands.enabled true 补全启动命令时自动插入关闭命令
guyeScript.dryRun.maxSteps 500 单次试运行最大命令步数,范围 10~100000
guyeScript.dryRun.maxTraceLines 5000 单次试运行最多输出的轨迹行数,范围 100~100000
guyeScript.dryRun.testDataFile .vscode/guye-script.test.json 公共初始测试数据模板路径
guyeScript.setup.promptOnStartup true 未配置 TXT 关联时提示初始化
guyeScript.setup.updateConfigurationOnUpgrade true 扩展升级后自动合并新增项目配置

示例:

{
    "guyeScript.cursorHover.delay": 500,
    "guyeScript.dryRun.maxSteps": 2000,
    "guyeScript.dryRun.maxTraceLines": 10000,
    "guyeScript.pairedCommands.enabled": true
}

十五、升级扩展与配置更新

升级是否需要先卸载

不需要。通过扩展商店安装后,VS Code 默认会自动更新扩展。也可以打开扩展视图,点击右上角的 …,选择“检查扩展更新”;看到“更新”按钮时点击更新,并按提示重新加载窗口。

卸载后重装可能会使排查过程变复杂,只有扩展文件损坏或 VS Code 无法正常更新时才建议这样做。工作区中的 .vscode/settings.json、代码块和测试数据属于项目文件,不会因为普通扩展升级而被主动删除。

新设置是否会自动写入 settings.json

默认设置 guyeScript.setup.updateConfigurationOnUpgrade 为 true。扩展升级后,会为已经初始化的项目合并新增配置:

  • 保留用户已经设置的值。
  • 补齐新增且缺少的初始化配置。
  • 迁移旧版格式化器 ID。
  • 缺少公共测试模板时补建 .vscode/guye-script.test.json。
  • 不覆盖现有测试数据。

如果关闭了自动更新,可随时重新执行“古叶脚本: 初始化当前项目配置”。

查看更新说明

执行命令“古叶脚本: 查看更新说明”,可在扩展界面中查看随扩展提供的更新日志。

十六、常见问题

1. 安装后没有高亮和补全

先看右下角是否为“古叶脚本”。如果不是,手动选择语言模式,然后执行初始化并重新加载窗口。

2. 初始化没有生成 .vscode/settings.json

确认当前窗口是通过“文件 → 打开文件夹…”打开的项目,而不是单独打开一个文件。多根工作区会要求选择目标文件夹,工作区级关联可能写入 .code-workspace 文件。

3. 初始化没有生成 guye-script.test.json

确认项目目录可写,再次执行初始化。启动逻辑试运行时也会检查并补建缺失的公共模板。

4. 为什么找不到当前脚本的测试数据

公共模板不等于当前脚本数据。至少启动一次当前脚本的逻辑试运行,扩展才会在 .vscode/guye-script.test/ 下按脚本相对路径创建独立 JSON。

5. 修改公共模板后,旧脚本为什么没有变化

公共模板只在某个脚本第一次建立独立数据文件时作为初始内容使用。已经生成的独立文件不会再次被模板覆盖,请直接修改对应的 <脚本文件名>.json。

6. JSON 报错,试运行无法启动

检查以下问题:

  • 是否使用双引号而不是中文引号或单引号。
  • 最后一项后面是否多了逗号。
  • 是否写了 // 或 -- 注释;标准 JSON 不允许注释。
  • variables、values、tasks、conditions、random、scenarios 是否为对象。
  • 任务状态是否为支持的四种中文状态或有效对象。

7. 条件写成 true 仍然不能跳转

如果命令本身带固定跳转目标,true 会使用该目标。如果命令没有固定目标,例如部分范围查询跳转,必须写目标字符串或 { "jump": true, "target": "标记" }。

8. 为什么脚本中的 // 后半段没有变成注释

扩展只把行首(允许前面有空格)的 // 和 -- 识别为注释。请把说明单独放到一行,不要使用行尾注释。

9. 试运行通过后是否说明游戏中一定正常

不是。试运行验证的是脚本的可分析控制流和你注入的数据场景,不能替代游戏环境、网络状态、坐标、背包、NPC 对话和时序等真实条件测试。

10. 如何避免无限循环

给循环准备明确的退出条件,并同时测试条件成立与不成立。试运行达到 guyeScript.dryRun.maxSteps 后会停止并报告,帮助定位疑似死循环。

十七、常用命令速查

打开命令面板后可执行:

  • 古叶脚本: 初始化当前项目配置
  • 古叶脚本: 查看更新说明
  • 古叶脚本: 逻辑试运行当前脚本
  • 古叶脚本: 停止逻辑试运行
  • 古叶脚本:保存所选内容为代码块

常用快捷键:

  • Ctrl/Cmd+Shift+P:打开命令面板。
  • Ctrl/Cmd+S:保存,并在默认配置下自动格式化。
  • F12:跳转到定义。
  • Shift+F12:查找引用。
  • F2:重命名标记或变量。
  • Ctrl/Cmd+.:显示快速修复。
  • Ctrl/Cmd+Shift+M:打开“问题”面板。

十八、反馈与源码

  • 项目主页:guye-script-assistant
  • 问题反馈:提交 Issue

反馈问题时,建议提供扩展版本、VS Code 版本、能够复现问题的最小脚本、问题面板或试运行输出,并删除账号、角色等不希望公开的信息。

支持作者

如果古叶脚本助手为你节省了排查和编写脚本的时间,欢迎自愿请作者喝杯饮料。感谢你的支持,也感谢每一条问题反馈和改进建议。

打赏码

点击查看打赏码原图

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft