求Illustrator JavaScript脚本：同步切换视图设置并解决状态查询问题

一、JSX脚本实现（直接可用） #

1. 进入像素预览模式脚本（隐藏画板/参考线/网格 + 开启像素预览） #

该脚本会先检查当前状态，仅在需要时执行切换，避免误操作：

//@target illustrator
preferences.setBooleanPreference("ShowExternalJSXWarning", false);

function enterPreviewMode() {
    if (!documents.length) {
        alert("请先打开一个文档再执行脚本");
        return;
    }
    var doc = app.activeDocument;
    
    // 隐藏画板边框
    if (doc.showArtboardBounds) {
        app.executeMenuCommand("artboard");
    }
    // 隐藏参考线
    if (doc.showGuides) {
        app.executeMenuCommand("showguide");
    }
    // 隐藏网格
    if (doc.showGrid) {
        app.executeMenuCommand("showgrid");
    }
    // 开启像素预览
    if (!doc.pixelPreview) {
        app.executeMenuCommand("raster");
    }
}

try {
    enterPreviewMode();
} catch (e) {
    alert("脚本执行出错：" + e.message);
}

2. 恢复编辑模式脚本（显示画板/参考线/网格 + 关闭像素预览） #

完全反向操作，同样基于当前状态精准切换：

//@target illustrator
preferences.setBooleanPreference("ShowExternalJSXWarning", false);

function enterEditMode() {
    if (!documents.length) {
        alert("请先打开一个文档再执行脚本");
        return;
    }
    var doc = app.activeDocument;
    
    // 显示画板边框
    if (!doc.showArtboardBounds) {
        app.executeMenuCommand("artboard");
    }
    // 显示参考线
    if (!doc.showGuides) {
        app.executeMenuCommand("showguide");
    }
    // 显示网格
    if (!doc.showGrid) {
        app.executeMenuCommand("showgrid");
    }
    // 关闭像素预览
    if (doc.pixelPreview) {
        app.executeMenuCommand("raster");
    }
}

try {
    enterEditMode();
} catch (e) {
    alert("脚本执行出错：" + e.message);
}

二、关键状态属性说明 #

你需要的几个显示/功能状态，都可以通过Illustrator DOM直接获取：

• app.activeDocument.showArtboardBounds：画板边框显示状态（布尔值）
• app.activeDocument.showGuides：参考线显示状态（布尔值）
• app.activeDocument.showGrid：网格显示状态（布尔值）
• app.activeDocument.pixelPreview：像素预览开启状态（布尔值）

通过判断这些属性的当前值，就能精准执行需要的切换操作，彻底解决之前的误切换问题。

三、CEP/UXP插件实现说明 #

可以通过自定义CEP或UXP插件实现该功能，两者核心逻辑和JSX脚本一致，只是载体更友好：

UXP插件（Adobe推荐的现代框架） #

• 直接调用Illustrator UXP API访问文档状态属性，部分属性支持直接赋值（比如doc.pixelPreview = true），无需调用菜单命令。
• 可制作带固定按钮的面板，集成到Illustrator界面，一键触发模式切换，操作更便捷。

CEP插件（旧框架，仍兼容） #

• 通过CSInterface对象调用JSX代码，本质和单独脚本逻辑相同，但可以封装成带UI的面板，固定在界面上长期使用。

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