列表在脚本里常见于地图许可名单、活动分组、行会联盟、区号过滤、自动回城点等场景。取字符串在列表中的位置，本质是把一个带分隔符的字符串按段编号，返回目标字符串所在的第几个位置。脚本可以用这个序号做优先级判断、分组归属、数组下标、发放奖励。不同引擎的分隔符规则和截取命令不一样，写之前先确认当前版本命令表，GOM、GEE、Hero、Blue四类引擎不能直接互相套用。
一、列表字符串的标准格式
最常用的是竖线分隔，例如D001D002
D003，位置从1开始编号。也有用英文逗号分隔的写法，例如D001D002D003。还有用星号、斜杠、中文字符做分隔的自定义形式。脚本里尽量全服统一一种分隔符，不要在同一段里混用竖号和逗号，否则截取时会把混用符号当成普通字符，导致位置错乱。列表开头和结尾不要留多余分隔符，尾部多余分隔符会让循环多取到一个空字符串，计数从正常序号偏移。检查方法是用GM命令把源变量输出到聊天框，肉眼看清楚首尾是否有多余空格、换行或隐藏字符。
二、引擎自带包含判断命令
GOM、GEE有CHECKINLIST命令，作用是判断一个字符串是否存在于一个用竖线分隔的列表中。常见用法：
IF
CHECKINLISTD001D001D002
D003
SAY
目标在列表中
此命令只判断在或不在，不直接返回位置编号。若业务只关心是否存在，用它先粗筛最快；若必须知道第几位，要进入循环截取。Hero、Blue相关命令名称和参数顺序可能存在差异，部分版本参数是列表在前、目标在后。改脚本前先用小号在NPC上实际跑一次，确认返回真假的机制，再批量接入正式逻辑。
三、GETSTR循环定位法
在GOM、GEE体系里最稳妥的做法是每次从列表中按位置截取一段，与目标字符串比对，匹配后记录当前轮次变量。核心命令是GETSTR，常见格式为：
GETSTR源字符串分隔符位置保存变量
位置参数从1开始。例如：
MOVS1D001D002
D003
GETSTRS1|2S2
执行后S2等于D002。要找出年卡在“月卡季卡年卡
至尊卡”中的位置，标准写法：
MOVS1月卡季卡年卡
至尊卡
MOVN01
MOVN10
[@查找循环]
GETSTRS1|N0S2
EQUALS2年卡
ACT
MOVN1N0
GOTO@查找结束
ELSEACT
INCN01
GOTO@查找循环
[@查找结束]
此时N1就是年卡所在位置，等于3。N1初始必须赋0，找不到时N1保持0，后续用LARGEN10判断是否存在，避免把无效序号当成有效数据。循环还要在N0超过列表总段数时强制跳出，否则会陷入无意义重复。
四、用总段数控制循环次数
循环前先确认列表一共有几段，避免N0无限增大。最简单的测试方法是人为指定总段数，例如手动MOVN84，适用于固定列表。正式脚本建议动态统计：先把列表复制到字符串变量，用替换命令把分隔符全部换成一个特殊标记，再统计标记出现次数加1得到总段数。GOM、GEE可用STRINGLENGTH或GETSTRINGLEN取长度，用REPLACESTR或StringReplace做替换。循环判断用SMALLN0N8，让N0从1走到列表总段数后自然结束，这样万一段落被改动也不会越界。
五、空段和连续分隔符处理
当列表出现D001||D003这样的连续分隔符时，GETSTR截取第二段会得到空字符串。EQUAL空字符串找不到目标，循环继续走。若想把空段排除在有效位置之外，在比对之前先判断截取结果是否为空，为空则直接INCN0继续下一轮。这样输出的N1表示去掉空段后的有效序号。若业务要求空段也算一个位置，就按原样计数，两种逻辑全服统一，不要混用。
六、多分隔符列表统一替换
有的列表混用竖线和逗号，例如D001|D002D003。处理步骤是先替换再查找。用替代命令把逗号换成竖线：
REPLACESTRS1|
替换后源变量统一为竖线分隔，再走GETSTR循环。注意替换顺序，若原列表同时存在竖线，先替换逗号不会影响原有竖线。替换完成后再保存回源变量，避免循环时重复替换。部分引擎替换命令只支持单字符批量替换，若分隔符是两个字符，要分两次替换或改用空标记办法。
七、双列表优先级判断
需要判断目标字符串在哪个列表位置更靠前时，分别调用两次查找过程，把位置存入两个数字变量，再用LARGE或SMALL比较。例如：
MOVN1目标在列表一的位置
MOVN2目标在列表二的位置
SMALLN1N2
ACT
SENDMSG5目标在列表一顺序更靠前
位置越小优先级越高。此类写法常用于活动地图按优先级进图、行会战按联盟排序、NPC按套装等级分配奖励。比较前先判断两个位置都不为0，再进入优先级分支，避免未命中字符串参与排序。
八、Hero与Blue引擎差异
Hero系列截取字符串命令通常不叫GETSTR，常见为GETS或GETSTRING，参数一般也包含源字符串、分隔符、位置、保存变量，但顺序和分隔符写法可能不同。Blue引擎有的用GETSTR，有的用INSTRING，还有的用EXTRACTSTRING，位置是否支持变量也要查命令表。部分引擎GETSTR的位置参数只接受常量，不接受N变量，此时要改用CALC或临时变量拼接方式实现动态定位。引擎更换后，最稳的做法是把原来一整段循环拆成单句测试：先固定截取第1个、第2个、第3个，看保存变量是否正确，再把位置改成N变量测试，最后接入循环。
九、找不到目标时的默认值
循环走完没有命中，N1保持初始0。后端逻辑先判断：
IF
LARGEN10
ACT
SENDMSG5位置是<$STR(N1)>
ELSEACT
MESSAGEBOX目标字符串不在列表中
若业务约定未命中按末尾处理，可把N1赋为总段数加1再继续。但注意不要把未命中和命中末位混为一谈，否则后续奖励发放会出现双份。所有调用位置结果的脚本，先读N1是否为0，再执行具体业务。
十、大小写与空格影响
列表和目标字符串必须完全一致，多一个空格都不会命中。比对前先把两边的前后空格去掉。GOM、GEE可用TRIM或替代命令处理空格，Hero用TRIMSTR或MOV加REPLACESTR去除。GETSTR截取出的段落也可能自带空格，先TRIM再EQUAL。全半角冒号、竖线、逗号也要统一，中文符号和英文符号会被当成不同字符串。消息变量输出时如果显示有隐藏空格，用字符码查看后再替换。
十一、地图列表序号实战
场景：角色当前地图D002，需要知道D002在允许进入列表D001D002
D003中的序号。
MOVS1D001D002
D003
MOVS2D002
MOVN01
MOVN10
[@定位开始]
GETSTRS1|N0S3
EQUALS2S3
ACT
MOVN1N0
GOTO@定位结束
ELSEACT
INCN01
SMALLN05
ACT
GOTO@定位开始
[@定位结束]
若N1等于3，说明D002是列表第三段。后续可用EQUALN13进入第三分段执行传送或发放奖励。地图列表通常定义在脚本变量或配置文本里，读取后先统一分隔符再进循环。
十二、多关键字分组实战
玩家输入型变量中可能同时包含多个关键字，先按空格或逗号拆成段落，再对每段执行查找定位。匹配到的位置用资产变量保存，最后在对话框逐行输出。循环嵌套时注意GOTO跳转只在当前脚本文件内有效，不要在QFunction和NPC文件之间跨文件跳，否则跳转标签会找不到。嵌套循环建议把内层查找单独抽成一个公共标签，外层循环只负责任和调用。
十三、长列表性能优化
列表有几千段时，每段一次GETSTR会明显拖慢NPC响应。优化先做粗筛：用CHECKINLIST判断目标是否在列表中，不在直接返回0，不再循环。频繁查找的目标尽量放在列表靠前位置，减少平均循环轮次。长列表在登录时载入内存变量，前后端共享，避免每次触发都从文件重新读。若列表按活动变化，只在活动切换时重新加载。脚本在循环体开头加总次数上限，防止死循环把服务器拖卡。
十四、常见错误排查
位置始终返回0：先单独测试GETSTR取第一段、第二段，确认位置参数从1开始；再确认保存变量是字符串变量不是数字变量；最后看分隔符是否被转义成别的字符。GOM、GEE中竖线在部分命令里可能被当成逻辑或符号，若程序自动转义，要用替换命令先换成安全占位符再截取。
结果总是返回第一位：说明EQUAL比对的是截取变量的残留值，没有在每轮循环重新读取GETSTR。检查循环标签开头是否重新执行了GETSTR，且保存变量每轮都被覆盖。
死循环：循环条件没有限定总段数，N0又没递增。在标签首行加INCN01，再用SMALLN0总段数控制继续。写完后先用最大次数5验证一轮，不要直接跑大列表。
列表尾部多一个分隔符：GETSTR最后一段为空，循环多跑一次，N1可能被空字符串覆盖。循环内先判断截取结果是否为空，为空则直接GOTO结束截取，不再进入比对。
不同引擎命令不兼容：GOM、GEE的GETSTR在Hero上不生效，必须改成Hero对应命令或改用脚本逻辑实现。引擎切换后逐段手工迁移，不要批量替换命令名称。
十五、通用查找函数思路
在QuestDiary或专用工能脚本里写一个公共定位函数，输入源列表变量、分隔符、目标字符串，输出位置变量。函数内先统一分隔符，再用GETSTR循环。所有泡点脚本、活动脚本、传送脚本统一调用这个函数，避免各处重复写循环。函数入口检查参数是否传满，参数缺失直接返回0。函数结尾用DEC或MOV清空临时变量，防止跨脚本污染。
十六、位置变量做数组下标
某些引擎支持用数字位置直接做数组下标，给对应位置的角色或物品发奖励。把N1位置值赋给数组变量后，按分组判断。数组下标只接受数字变量，如果位置保存在字符串变量里，先转换成数字再使用。取到的位置超过数组长度上限时，先用LARGE比较再访问，避免数组越界报错。数组下标从0还是从1开始也要按引擎定义对齐，GETSTR位置从1开始时，数组下标可能要从0开始，这时对N1减1再赋给数组。
十七、发布前验证流程
新写的查找脚本用GM账号至少跑四组用例：目标在列表开头、目标在列表中间、目标在列表末尾、目标完全不在列表。四组分别输出位置值，记录是否符合预期。再跑一组空列表、一组含空段的坏列表，确认脚本不报错不卡死。最后放在测试NPC上单次触发，观察M2日志有无脚本异常。全部通过后再接入正式NPC和服务端，避免低级的截取错误影响到玩家。
一、列表字符串的标准格式
最常用的是竖线分隔，例如D001D002
D003，位置从1开始编号。也有用英文逗号分隔的写法，例如D001D002D003。还有用星号、斜杠、中文字符做分隔的自定义形式。脚本里尽量全服统一一种分隔符，不要在同一段里混用竖号和逗号，否则截取时会把混用符号当成普通字符，导致位置错乱。列表开头和结尾不要留多余分隔符，尾部多余分隔符会让循环多取到一个空字符串，计数从正常序号偏移。检查方法是用GM命令把源变量输出到聊天框，肉眼看清楚首尾是否有多余空格、换行或隐藏字符。
二、引擎自带包含判断命令
GOM、GEE有CHECKINLIST命令，作用是判断一个字符串是否存在于一个用竖线分隔的列表中。常见用法：
IF
CHECKINLISTD001D001D002
D003
SAY
目标在列表中
此命令只判断在或不在，不直接返回位置编号。若业务只关心是否存在，用它先粗筛最快；若必须知道第几位，要进入循环截取。Hero、Blue相关命令名称和参数顺序可能存在差异，部分版本参数是列表在前、目标在后。改脚本前先用小号在NPC上实际跑一次，确认返回真假的机制，再批量接入正式逻辑。
三、GETSTR循环定位法
在GOM、GEE体系里最稳妥的做法是每次从列表中按位置截取一段，与目标字符串比对，匹配后记录当前轮次变量。核心命令是GETSTR，常见格式为：
GETSTR源字符串分隔符位置保存变量
位置参数从1开始。例如：
MOVS1D001D002
D003
GETSTRS1|2S2
执行后S2等于D002。要找出年卡在“月卡季卡年卡
至尊卡”中的位置，标准写法：
MOVS1月卡季卡年卡
至尊卡
MOVN01
MOVN10
[@查找循环]
GETSTRS1|N0S2
EQUALS2年卡
ACT
MOVN1N0
GOTO@查找结束
ELSEACT
INCN01
GOTO@查找循环
[@查找结束]
此时N1就是年卡所在位置，等于3。N1初始必须赋0，找不到时N1保持0，后续用LARGEN10判断是否存在，避免把无效序号当成有效数据。循环还要在N0超过列表总段数时强制跳出，否则会陷入无意义重复。
四、用总段数控制循环次数
循环前先确认列表一共有几段，避免N0无限增大。最简单的测试方法是人为指定总段数，例如手动MOVN84，适用于固定列表。正式脚本建议动态统计：先把列表复制到字符串变量，用替换命令把分隔符全部换成一个特殊标记，再统计标记出现次数加1得到总段数。GOM、GEE可用STRINGLENGTH或GETSTRINGLEN取长度，用REPLACESTR或StringReplace做替换。循环判断用SMALLN0N8，让N0从1走到列表总段数后自然结束，这样万一段落被改动也不会越界。
五、空段和连续分隔符处理
当列表出现D001||D003这样的连续分隔符时，GETSTR截取第二段会得到空字符串。EQUAL空字符串找不到目标，循环继续走。若想把空段排除在有效位置之外，在比对之前先判断截取结果是否为空，为空则直接INCN0继续下一轮。这样输出的N1表示去掉空段后的有效序号。若业务要求空段也算一个位置，就按原样计数，两种逻辑全服统一，不要混用。
六、多分隔符列表统一替换
有的列表混用竖线和逗号，例如D001|D002D003。处理步骤是先替换再查找。用替代命令把逗号换成竖线：
REPLACESTRS1|
替换后源变量统一为竖线分隔，再走GETSTR循环。注意替换顺序，若原列表同时存在竖线，先替换逗号不会影响原有竖线。替换完成后再保存回源变量，避免循环时重复替换。部分引擎替换命令只支持单字符批量替换，若分隔符是两个字符，要分两次替换或改用空标记办法。
七、双列表优先级判断
需要判断目标字符串在哪个列表位置更靠前时，分别调用两次查找过程，把位置存入两个数字变量，再用LARGE或SMALL比较。例如：
MOVN1目标在列表一的位置
MOVN2目标在列表二的位置
SMALLN1N2
ACT
SENDMSG5目标在列表一顺序更靠前
位置越小优先级越高。此类写法常用于活动地图按优先级进图、行会战按联盟排序、NPC按套装等级分配奖励。比较前先判断两个位置都不为0，再进入优先级分支，避免未命中字符串参与排序。
八、Hero与Blue引擎差异
Hero系列截取字符串命令通常不叫GETSTR，常见为GETS或GETSTRING，参数一般也包含源字符串、分隔符、位置、保存变量，但顺序和分隔符写法可能不同。Blue引擎有的用GETSTR，有的用INSTRING，还有的用EXTRACTSTRING，位置是否支持变量也要查命令表。部分引擎GETSTR的位置参数只接受常量，不接受N变量，此时要改用CALC或临时变量拼接方式实现动态定位。引擎更换后，最稳的做法是把原来一整段循环拆成单句测试：先固定截取第1个、第2个、第3个，看保存变量是否正确，再把位置改成N变量测试，最后接入循环。
九、找不到目标时的默认值
循环走完没有命中，N1保持初始0。后端逻辑先判断：
IF
LARGEN10
ACT
SENDMSG5位置是<$STR(N1)>
ELSEACT
MESSAGEBOX目标字符串不在列表中
若业务约定未命中按末尾处理，可把N1赋为总段数加1再继续。但注意不要把未命中和命中末位混为一谈，否则后续奖励发放会出现双份。所有调用位置结果的脚本，先读N1是否为0，再执行具体业务。
十、大小写与空格影响
列表和目标字符串必须完全一致，多一个空格都不会命中。比对前先把两边的前后空格去掉。GOM、GEE可用TRIM或替代命令处理空格，Hero用TRIMSTR或MOV加REPLACESTR去除。GETSTR截取出的段落也可能自带空格，先TRIM再EQUAL。全半角冒号、竖线、逗号也要统一，中文符号和英文符号会被当成不同字符串。消息变量输出时如果显示有隐藏空格，用字符码查看后再替换。
十一、地图列表序号实战
场景：角色当前地图D002，需要知道D002在允许进入列表D001D002
D003中的序号。
MOVS1D001D002
D003
MOVS2D002
MOVN01
MOVN10
[@定位开始]
GETSTRS1|N0S3
EQUALS2S3
ACT
MOVN1N0
GOTO@定位结束
ELSEACT
INCN01
SMALLN05
ACT
GOTO@定位开始
[@定位结束]
若N1等于3，说明D002是列表第三段。后续可用EQUALN13进入第三分段执行传送或发放奖励。地图列表通常定义在脚本变量或配置文本里，读取后先统一分隔符再进循环。
十二、多关键字分组实战
玩家输入型变量中可能同时包含多个关键字，先按空格或逗号拆成段落，再对每段执行查找定位。匹配到的位置用资产变量保存，最后在对话框逐行输出。循环嵌套时注意GOTO跳转只在当前脚本文件内有效，不要在QFunction和NPC文件之间跨文件跳，否则跳转标签会找不到。嵌套循环建议把内层查找单独抽成一个公共标签，外层循环只负责任和调用。
十三、长列表性能优化
列表有几千段时，每段一次GETSTR会明显拖慢NPC响应。优化先做粗筛：用CHECKINLIST判断目标是否在列表中，不在直接返回0，不再循环。频繁查找的目标尽量放在列表靠前位置，减少平均循环轮次。长列表在登录时载入内存变量，前后端共享，避免每次触发都从文件重新读。若列表按活动变化，只在活动切换时重新加载。脚本在循环体开头加总次数上限，防止死循环把服务器拖卡。
十四、常见错误排查
位置始终返回0：先单独测试GETSTR取第一段、第二段，确认位置参数从1开始；再确认保存变量是字符串变量不是数字变量；最后看分隔符是否被转义成别的字符。GOM、GEE中竖线在部分命令里可能被当成逻辑或符号，若程序自动转义，要用替换命令先换成安全占位符再截取。
结果总是返回第一位：说明EQUAL比对的是截取变量的残留值，没有在每轮循环重新读取GETSTR。检查循环标签开头是否重新执行了GETSTR，且保存变量每轮都被覆盖。
死循环：循环条件没有限定总段数，N0又没递增。在标签首行加INCN01，再用SMALLN0总段数控制继续。写完后先用最大次数5验证一轮，不要直接跑大列表。
列表尾部多一个分隔符：GETSTR最后一段为空，循环多跑一次，N1可能被空字符串覆盖。循环内先判断截取结果是否为空，为空则直接GOTO结束截取，不再进入比对。
不同引擎命令不兼容：GOM、GEE的GETSTR在Hero上不生效，必须改成Hero对应命令或改用脚本逻辑实现。引擎切换后逐段手工迁移，不要批量替换命令名称。
十五、通用查找函数思路
在QuestDiary或专用工能脚本里写一个公共定位函数，输入源列表变量、分隔符、目标字符串，输出位置变量。函数内先统一分隔符，再用GETSTR循环。所有泡点脚本、活动脚本、传送脚本统一调用这个函数，避免各处重复写循环。函数入口检查参数是否传满，参数缺失直接返回0。函数结尾用DEC或MOV清空临时变量，防止跨脚本污染。
十六、位置变量做数组下标
某些引擎支持用数字位置直接做数组下标，给对应位置的角色或物品发奖励。把N1位置值赋给数组变量后，按分组判断。数组下标只接受数字变量，如果位置保存在字符串变量里，先转换成数字再使用。取到的位置超过数组长度上限时，先用LARGE比较再访问，避免数组越界报错。数组下标从0还是从1开始也要按引擎定义对齐，GETSTR位置从1开始时，数组下标可能要从0开始，这时对N1减1再赋给数组。
十七、发布前验证流程
新写的查找脚本用GM账号至少跑四组用例：目标在列表开头、目标在列表中间、目标在列表末尾、目标完全不在列表。四组分别输出位置值，记录是否符合预期。再跑一组空列表、一组含空段的坏列表，确认脚本不报错不卡死。最后放在测试NPC上单次触发，观察M2日志有无脚本异常。全部通过后再接入正式NPC和服务端，避免低级的截取错误影响到玩家。