本文将详细介绍如何使用adobe photoshop脚本（extendscript）来检测当前活动文档中是否存在参考线。我们将提供一个实用的脚本示例，该脚本能够根据参考线的存在与否，智能地执行不同的自动化操作，例如当没有参考线时自动全选画布，或者在有参考线时执行用户自定义的动作。文章将深入解析关键代码逻辑，包括如何判断文档是否存在选区，以确保脚本的健壮性和用户体验。
在Photoshop的自动化工作流程中，经常需要根据文档的特定状态来执行不同的操作。其中一个常见需求是判断文档中是否存在参考线（Guides），并据此触发后续的脚本逻辑。例如，如果文档中没有参考线，我们可能希望脚本自动创建一个全选选区；如果存在参考线，则执行其他预设的动作。
检测文档中的参考线
Photoshop的ExtendScript API提供了一个直观的方式来访问当前文档的参考线信息。app.activeDocument.guides 属性返回一个 Guides 集合，其中包含了文档中所有的参考线对象。要判断是否存在参考线，最直接的方法是检查这个集合的 length 属性。
如果 app.activeDocument.guides.length 的值为 0，则表示文档中没有参考线；如果大于 0，则表示存在参考线。
脚本实现：条件判断与操作执行
基于上述检测机制，我们可以构建一个脚本来根据参考线的存在情况执行不同的操作。以下是一个核心逻辑示例：
通过跨平台桥接执行 ExtendScript (ES3) 脚本，自动化 Photoshop、Illustrator、InDesign、Premiere Pro 和 After Effects。
if (app.activeDocument.guides.length) {
// 如果存在参考线，执行您的自定义动作
// 例如：alert("文档中存在参考线，执行特定任务...");
// app.doAction("MyCustomActionSet", "MyCustomAction");
} else {
// 如果没有参考线，执行默认操作，例如全选
// 确保在执行全选前检查是否已经有选区，避免不必要的覆盖
if (!hasSelection(app.activeDocument)) {
app.activeDocument.selection.selectAll();
}
}在上面的 else 分支中，我们引入了一个 hasSelection 函数。这个函数的目的是在执行 selectAll() 之前，先判断当前文档是否已经存在一个选区。这样做是为了避免无条件地覆盖用户可能已经创建的选区，从而提高脚本的智能性和用户友好性。
判断文档是否存在选区
判断文档是否存在选区需要一些技巧，因为 selection 对象本身总是存在的，但它的 bounds 属性只有在有实际选区时才能被访问。尝试访问一个空选区的 bounds 会抛出错误。因此，我们可以利用 try-catch 语句来安全地判断：
/**
* 检查指定文档是否包含活动选区。
* @param {Document} doc - 要检查的Photoshop文档对象。
* @returns {boolean} 如果文档有选区则返回 true，否则返回 false。
*/
function hasSelection(doc) {
try {
// 尝试访问选区的bounds属性。如果成功，说明有选区。
// bounds属性返回一个数组，其长度大于0表示存在选区。
return doc.selection.bounds.length > 0;
} catch (err) {
// 如果访问bounds属性抛出错误，说明没有活动选区。
return false;
}
}完整脚本示例
将上述逻辑整合，我们可以得到一个完整的Photoshop自动化脚本：
#target photoshop
// 设置Photoshop首选项，例如单位（可选，但推荐）
app.preferences.rulerUnits = Units.PIXELS;
// 关闭所有对话框，使脚本静默运行
app.displayDialogs = DialogModes.NO;
// 确保有活动文档
if (app.documents.length === 0) {
alert("请先打开一个Photoshop文档！");
} else {
var activeDoc = app.activeDocument;
// 检查文档中是否存在参考线
if (activeDoc.guides.length > 0) {
// 存在参考线时的操作
alert("文档中存在 " + activeDoc.guides.length + " 条参考线。");
// 在这里可以调用一个预设的动作集和动作
// 例如：app.doAction("我的动作集", "处理参考线");
// 或者执行其他脚本逻辑
// console.log("执行与参考线相关的任务...");
} else {
// 不存在参考线时的操作
alert("文档中没有参考线。");
// 检查是否已有选区，如果没有则全选
if (!hasSelection(activeDoc)) {
activeDoc.selection.selectAll();
alert("已自动全选画布。");
} else {
alert("文档中已有选区，未执行全选操作。");
}
}
}
/**
* 检查指定文档是否包含活动选区。
* @param {Document} doc - 要检查的Photoshop文档对象。
* @returns {boolean} 如果文档有选区则返回 true，否则返回 false。
*/
function hasSelection(doc) {
try {
// 尝试访问选区的bounds属性。如果成功，说明有选区。
// bounds属性返回一个数组，其长度大于0表示存在选区。
return doc.selection.bounds.length > 0;
} catch (err) {
// 如果访问bounds属性抛出错误，说明没有活动选区。
return false;
}
}
// 恢复Photoshop首选项（如果之前修改过）
// app.preferences.rulerUnits = savedRulerUnits; // 如果保存了原始单位注意事项
- 错误处理： 在实际应用中，确保脚本在没有活动文档时能优雅地处理，例如通过 if (app.documents.length === 0) 进行检查。
- 单位设置： 尽管本例中检测参考线长度不直接依赖于单位，但在进行其他操作（如创建选区或测量）时，设置 app.preferences.rulerUnits 是一个好习惯，可以避免因单位不一致导致的问题。
- 自定义动作： 当存在参考线时，您可以替换 alert 语句为更复杂的脚本逻辑，或者通过 app.doAction("动作集名称", "动作名称") 调用Photoshop中预设的动作。
- 用户反馈： 脚本中适当地使用 alert() 或 console.log() 可以为用户提供反馈，让他们了解脚本正在执行什么操作。在生产环境中，可能需要更精细的日志记录或UI反馈。
总结
通过利用 app.activeDocument.guides.length 属性和 hasSelection 辅助函数，我们可以编写出智能且用户友好的Photoshop脚本，根据文档中是否存在参考线来执行不同的自动化任务。这种条件判断的能力极大地扩展了Photoshop脚本的实用性，使其能够更好地适应复杂的工作流程需求。
