本文详解在启用 Artboard 的 Photoshop 文档中，如何通过图层名称准确定位并操作 Artboard 内部的文本图层，避免因 Artboard 结构导致的 getByName 失效问题。
本文详解在启用 artboard 的 photoshop 文档中，如何通过图层名称准确定位并操作 artboard 内部的文本图层，避免因 artboard 结构导致的 `getbyname` 失效问题。
在 Photoshop 中启用 Artboard 后，文档结构发生本质变化：Artboard 并非视觉容器，而是特殊类型的图层组（LayerSet），其内部图层（包括文字图层）被嵌套在该组下。因此，直接调用 activeDocument.artLayers.getByName("layer_1") 会失败——因为该图层已不属于顶层 artLayers 集合，而属于某个 Artboard 组的子图层。
要正确访问 Artboard 内的图层，必须按层级路径查找：先通过 layerSets.getByName("Artboard 名称") 获取目标 Artboard（即顶层图层组），再在其子集 artLayers 中检索目标图层。以下是完整、健壮的脚本示例：
#target photoshop;
var fileRef = new File("I:/ps15.psd");
if (!fileRef.exists) {
alert("File not found");
exit();
}
app.open(fileRef);
var doc = app.activeDocument;
try {
// ✅ 正确方式：定位 Artboard "Artboard 1" 下名为 "layer_1" 的文本图层
var artboard = doc.layerSets.getByName("Artboard 1"); // 注意：名称需完全匹配（含空格/大小写）
var targetLayer = artboard.artLayers.getByName("layer_1");
doc.activeLayer = targetLayer;
targetLayer.textItem.contents = "Hi!";
doc.close(SaveOptions.SAVECHANGES);
} catch (e) {
// ⚠️ 常见错误捕获：Artboard 名称错误、图层不存在、非文本图层等
if (e.number === 8004) { // Photoshop 错误码：未找到图层
alert("Artboard 或图层名称不匹配，请检查名称是否准确（区分大小写与空格）");
} else if (e.number === 8007) { // 图层无 textItem 属性
alert("指定图层不是文本图层，请确认图层类型");
} else {
alert("脚本执行出错: " + e.message);
}
doc.close(SaveOptions.DONOTSAVECHANGES);
}
关键注意事项：
- Artboard 名称必须完全一致（区分大小写、空格、标点），建议在 Photoshop 中右键 Artboard → “重命名”后复制粘贴名称；
- 若 Artboard 嵌套在其他图层组中（如“Design Assets”组内），需逐级访问：doc.layerSets.getByName("Design Assets").layerSets.getByName("Artboard 1")；
- layerSets 是顶层图层组集合，Artboard 在脚本中即表现为 layerSet 类型对象，而非独立 API 类型；
- 推荐始终使用 try/catch 包裹操作，避免因名称错误导致脚本中断；
- 如需批量处理多个 Artboard，可遍历 doc.layerSets 并筛选 isArtboard 属性（CS6+ 支持）：if (layerSet.isArtboard) {...}。
掌握这一层级访问逻辑，即可无缝兼容传统 PSD 与 Artboard 项目，在自动化模板填充、批量导出等场景中稳定可靠地操作任意嵌套层级的文本图层。
