萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript (ExtendScript) 批量修改 Photoshop 圖層名稱腳本

腳本用途

在 Adobe Photoshop 中批量重命名所有圖層(不含圖層組內部),命名規則為 `name0`、`name1`... 適用於規範圖層命名、導出資源前預處理。

完整腳本代碼 (.jsx)

#target photoshop

app.bringToFront();

if (documents.length === 0) {
    alert("沒有可處理的文檔");
} else {
    var docRef = activeDocument;
    var layers = docRef.layers;
    
    // 單圖層且為背景圖層時不可隱藏(不影響重命名,但官方示例保留此判斷)
    if (layers.length === 1 && docRef.activeLayer.isBackgroundLayer) {
        alert("The Background layer can not be hidden when it is the only layer in a document.");
    } else {
        for (var i = 0; i < layers.length; i++) {
            var newName = "name" + i; // 自定義命名規則
            layers[i].name = newName;
        }
    }
}

使用方法

  1. 將代碼保存為 `renameLayers.jsx`(UTF-8 編碼)。
  2. 在 Photoshop 中:`文件` → `腳本` → `瀏覽...` 選中該文件運行。
  3. 或放入 `Presets/Scripts` 目錄重啟 PS 後在 `文件` → `腳本` 菜單直接調用。

關鍵 API 說明

對象/屬性/方法說明
`app.documents`打開的文檔集合
`activeDocument`當前活動文檔
`document.layers`頂層圖層集合(`LayerSet` 圖層組也在其中,但 `layers[i].layers` 可訪問組內圖層)
`layer.name`圖層名稱,可讀寫
`layer.isBackgroundLayer`是否為背景圖層(鎖定、不可移動、不可刪除)

局限與擴展

  • 不支持圖層組遞歸:僅遍歷頂層 `docRef.layers`,組內圖層不處理。需遞歸遍歷 `layerSet.layers`。
  • 命名衝突:若原有同名圖層,PS 會自動在末尾加序號(如 `name0 copy`),腳本不報錯但結果可能不符預期。
  • 擴展:遞歸處理所有圖層(含組內):
    function renameAllLayers(layerSet, prefix, counter) {
        for (var i = 0; i < layerSet.layers.length; i++) {
            var lyr = layerSet.layers[i];
            if (lyr.typename === "LayerSet") { // 圖層組
                renameAllLayers(lyr, prefix, counter);
            } else {
                lyr.name = prefix + counter[0]++;
            }
        }
    }
    var cnt = [0];
    renameAllLayers(activeDocument, "layer_", cnt);
  • 撤銷支持**:將操作包裹在 `app.activeDocument.suspendHistory('批量重命名', 'renameAllLayers(...)')` 中,支持 `Ctrl+Z` 一鍵撤銷。

ExtendScript 開發提示

  • 使用 **VS Code + ExtendScript Debugger** 擴展調試(需安裝 Adobe ExtendScript Toolkit 或使用 `@adobe/extendscript-debug`)。
  • 查閱官方文檔:`Adobe Photoshop CC JavaScript Scripting Reference`。
  • 現代替代方案:**UXP (Unified Extensibility Platform)** 插件開發(JavaScript/TypeScript + React,支持現代工具鏈、異步 API、模塊化),ExtendScript 將逐步淘汰。
copyright © 萬盛學電腦網 all rights reserved