本教程详细介绍了如何使用Adobe Photoshop的ExtendScript编写脚本，以检测当前文档中是否存在参考线。脚本将根据检测结果执行不同的操作：如果存在参考线，则执行预定义动作；如果不存在参考线且当前文档没有活动选区，则执行“全选”操作。文章涵盖了核心逻辑、选择区检测函数以及完整的示例代码，旨在帮助用户实现自动化工作流程。
在Adobe Photoshop中，自动化工作流程是提高效率的关键。ExtendScript作为Photoshop的脚本语言，允许用户编写自定义脚本来执行一系列操作。本教程将指导您如何创建一个ExtendScript脚本，该脚本能够智能地检测当前文档中是否存在参考线（guides），并根据检测结果执行不同的条件操作，例如执行特定动作或创建“全选”选区。
1. 核心逻辑：检测参考线
检测文档中是否存在参考线是脚本的基础。Photoshop的Document对象提供了一个guides集合，我们可以通过检查其length属性来判断参考线的数量。
#target photoshop
// 确保有文档打开
if (!app.documents.length) {
alert("请先打开一个Photoshop文档。");
return;
}
var doc = app.activeDocument;
// 检查文档中参考线的数量
if (doc.guides.length > 0) {
// 如果存在参考线，执行特定操作
alert("检测到参考线！将执行预设动作。");
// 在这里添加您的自定义动作代码，例如：
// app.doAction("我的动作集", "我的动作名称");
// doc.activeLayer.adjustBrightnessContrast(10, 0);
} else {
// 如果不存在参考线，执行另一组操作
alert("未检测到参考线。");
// 在这里添加当没有参考线时需要执行的代码
}在上述代码中，doc.guides.length会返回文档中水平和垂直参考线的总数。如果这个值大于0，则表示文档中存在至少一条参考线。
2. 增强逻辑：检测选区并条件性“全选”
在某些情况下，当没有参考线时，我们可能希望创建一个“全选”选区。然而，如果文档中已经存在一个选区，我们可能不希望覆盖它。因此，我们需要一个方法来判断当前文档是否已经有活动选区。
Photoshop的selection对象在没有选区时，尝试访问其bounds属性会抛出错误。我们可以利用这一点，结合try-catch块来安全地检测选区是否存在。
2.1 hasSelection 辅助函数
为了代码的整洁和复用性，我们封装一个hasSelection函数来完成选区检测：
/**
* 检查当前文档是否包含活动选区。
* @param {Document} doc - 当前活动的Photoshop文档对象。
* @returns {boolean} 如果存在选区则返回true，否则返回false。
*/
function hasSelection(doc) {
try {
// 尝试访问选区的边界。如果不存在选区，此操作会抛出错误。
// 如果存在选区，bounds会返回一个包含四个坐标的数组，其length > 0。
return doc.selection.bounds.length > 0;
} catch (err) {
// 如果发生错误，说明没有选区
return false;
}
}这个函数接收一个Document对象作为参数，并尝试访问doc.selection.bounds。如果成功，说明存在选区；如果捕获到错误，则表示没有选区。
2.2 整合条件“全选”逻辑
现在，我们可以将hasSelection函数整合到主脚本中，以实现更智能的“全选”操作：
// ... (之前的代码)
if (doc.guides.length > 0) {
// ... (存在参考线时的操作)
} else {
// 如果不存在参考线
if (!hasSelection(doc)) {
// 如果没有选区，则执行“全选”
doc.selection.selectAll();
alert("未检测到参考线，且无活动选区。已执行 '全选' 操作。");
} else {
// 如果不存在参考线，但已有选区，则不进行“全选”
alert("未检测到参考线，但已存在活动选区。未执行 '全选' 操作。");
}
}3. 完整的脚本示例
将上述所有组件整合，我们得到一个功能完善的Photoshop ExtendScript脚本：
#target photoshop
/**
* 检查当前文档是否包含活动选区。
* @param {Document} doc - 当前活动的Photoshop文档对象。
* @returns {boolean} 如果存在选区则返回true，否则返回false。
*/
function hasSelection(doc) {
try {
// 尝试访问选区的边界。如果不存在选区，此操作会抛出错误。
return doc.selection.bounds.length > 0;
} catch (err) {
// 如果发生错误，说明没有选区
return false;
}
}
// 主脚本执行块
(function() {
// 确保有文档打开
if (!app.documents.length) {
alert("请先打开一个Photoshop文档以运行此脚本。");
return;
}
var doc = app.activeDocument;
// 1. 检测文档中参考线的数量
if (doc.guides.length > 0) {
// --- 场景一：文档中存在参考线 ---
alert("检测到文档中存在 " + doc.guides.length + " 条参考线。");
// 在这里放置当检测到参考线时您希望执行的自定义操作。
// 示例：可以调用一个Photoshop动作，或者执行其他脚本功能。
// app.doAction("我的自定义动作集", "处理参考线动作");
// doc.activeLayer.invert(); // 反相当前图层作为示例
// alert("已执行 '存在参考线' 时的操作。");
} else {
// --- 场景二：文档中不存在参考线 ---
alert("文档中未检测到任何参考线。");
// 2. 进一步检查是否存在活动选区
if (!hasSelection(doc)) {
// 如果没有选区，则执行“全选”操作
doc.selection.selectAll();
alert("文档中无参考线且无活动选区，已执行 '全选' 操作。");
} else {
// 如果不存在参考线，但已有选区，则不做任何选区操作
alert("文档中无参考线，但已存在活动选区。未执行 '全选' 操作。");
}
}
})();4. 使用与注意事项
- 保存脚本：将上述代码保存为 .jsx 文件（例如 ConditionalGuideAction.jsx）。
- 运行脚本：在Photoshop中，可以通过 文件 > 脚本 > 浏览... 菜单选择并运行该脚本。
- 自定义动作：在脚本中标记为“在这里放置当检测到参考线时您希望执行的自定义操作”的地方，您可以替换为实际的Photoshop ExtendScript代码，例如调用app.doAction()执行预设的Photoshop动作，或者直接操作图层、调整图像等。
- 错误处理：虽然hasSelection函数已经包含了基本的错误处理，但在更复杂的脚本中，您可能需要添加更多的错误检查和用户反馈机制。
- 单位设置：原始问题中提到了app.preferences.rulerUnits = Units.PIXELS;。虽然在这个特定的逻辑中不直接需要，但在进行像素级别的选区或测量操作时，设置单位是一个好习惯。本教程的脚本主要关注参考线计数和选区存在性，因此省略了这部分以保持核心逻辑的简洁。
总结
通过本教程，您学会了如何编写一个Photoshop ExtendScript脚本，该脚本能够智能地检测文档中参考线的存在，并根据是否存在参考线以及当前选区状态，执行不同的自动化操作。这种条件逻辑是构建更复杂、更智能的自动化工作流程的基础，极大地提高了Photoshop用户的工作效率和灵活性。您可以根据自己的具体需求，扩展脚本中的条件动作，实现更多样化的自动化任务。
