如何在Photoshop脚本中访问画板（Artboard）内的指定图层

在包含画板（Artboard）的PSD文件中，画板属于特殊的图层容器，内部图层不会直接出现在activeDocument.artLayers集合中，因此需要调整图层查找逻辑：

方法1：指定画板查找（已知画板名称时使用） #

直接定位目标画板，再从画板的子图层中查找目标文本图层：

#target photoshop;

var fileRef = new File("I:/ps15.psd");

if (fileRef.exists) {
    app.open(fileRef);
    var doc = activeDocument;
    
    // 定位目标画板
    var targetArtboard = doc.layers.getByName("你的画板名称");
    // 在画板子图层中找到目标文本图层
    var targetLayer = targetArtboard.layers.getByName("layer_1");
    
    // 确认是文本图层后修改内容
    if (targetLayer.kind === LayerKind.TEXT) {
        targetLayer.textItem.contents = "Hi!";
    }
    
    doc.close(SaveOptions.SAVECHANGES);
} else {
    alert("File not found");
}

方法2：递归全局查找（通用场景） #

通过递归遍历所有图层（包括画板、嵌套图层组内的图层），直接按名称定位目标图层：

#target photoshop;

var fileRef = new File("I:/ps15.psd");

if (fileRef.exists) {
    app.open(fileRef);
    var doc = activeDocument;
    
    // 递归查找指定名称的图层
    function findLayerByName(layerContainer, targetName) {
        for (var i = 0; i < layerContainer.layers.length; i++) {
            var currentLayer = layerContainer.layers[i];
            if (currentLayer.name === targetName) {
                return currentLayer;
            }
            // 若当前是容器类图层（画板/图层组），继续递归查找子图层
            if (currentLayer.typename !== "ArtLayer") {
                var foundLayer = findLayerByName(currentLayer, targetName);
                if (foundLayer) return foundLayer;
            }
        }
        return null;
    }
    
    var targetLayer = findLayerByName(doc, "layer_1");
    
    if (targetLayer && targetLayer.kind === LayerKind.TEXT) {
        targetLayer.textItem.contents = "Hi!";
    } else {
        alert("目标图层未找到或不是文本图层");
    }
    
    doc.close(SaveOptions.SAVECHANGES);
} else {
    alert("File not found");
}

注意事项 #

• 务必判断目标图层类型为LayerKind.TEXT，避免非文本图层调用textItem导致脚本报错；
• 若存在重名图层，递归方法会返回第一个匹配的图层，需确保图层名称唯一。

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