Photoshop脚本报错：选中图层网格排列失败（Error21）求修复

问题根源 #

原脚本的核心错误有3点：

1. 错误访问图层属性：doc.activeLayer.layers仅适用于图层组（LayerSet），若当前激活的是普通图层，layers属性不存在，直接调用会触发undefined is not an object错误。
2. 需求逻辑偏差：你要排列的是所有选中图层，而非激活图层组内的子图层，原脚本的图层获取逻辑完全不符合需求。
3. 位移方式错误：translate()是相对位移，会叠加图层原有位置，无法实现规整的绝对网格排列；同时行/列计算逻辑颠倒，导致排列顺序混乱。

修复后的脚本 #

var doc = app.activeDocument;
var selectedLayers = [];

// 递归收集所有选中的图层（含嵌套组内的图层）
function collectSelectedLayers(layerSet) {
    for (var i = 0; i < layerSet.layers.length; i++) {
        var layer = layerSet.layers[i];
        if (layer.selected) {
            selectedLayers.push(layer);
        }
        // 若当前是图层组，递归遍历子图层
        if (layer.typename === "LayerSet") {
            collectSelectedLayers(layer);
        }
    }
}

// 执行图层收集
collectSelectedLayers(doc);

if (selectedLayers.length > 0) {
    var cols = 11; // 自定义列数
    var xOffset = 512; // 横向网格间距（含图层宽度，可按需调整）
    var yOffset = 512; // 纵向网格间距（含图层高度，可按需调整）
    var rows = Math.ceil(selectedLayers.length / cols); // 自动计算所需行数

    for (var i = 0; i < selectedLayers.length; i++) {
        var layer = selectedLayers[i];
        var colIndex = i % cols;
        var rowIndex = Math.floor(i / cols);
        // 设置图层绝对位置（Photoshop坐标原点为左上角，Y轴向下）
        layer.position = [colIndex * xOffset, rowIndex * yOffset];
    }

    alert("网格排列完成！共处理 " + selectedLayers.length + " 个图层。");
} else {
    alert("未选中任何图层，请先选择需要排列的图层！");
}

关键修改说明 #

• 选中图层收集逻辑：新增递归函数collectSelectedLayers，可以遍历文档所有图层（包括嵌套在组内的图层），筛选出选中的图层，完全匹配你的需求。
• 绝对位置定位：改用layer.position设置图层的绝对坐标，确保每个图层精准落在网格节点上，避免相对位移的叠加问题。
• 修正排列逻辑：用列数cols计算行索引，保证图层按从左到右、从上到下的顺序排列成规整网格；同时自动计算所需行数，无需手动固定设置。
• 错误提示优化：明确提示未选中图层的情况，以及处理完成后的图层数量，提升易用性。

内容的提问来源于stack exchange，提问作者Jonathan Kaiser