Python 的 Aspose.PSD FOSS
开源 Python 库，用于加载、检查和保存 PSD/PSB 文件，并支持图层元数据访问。采用 MIT 许可证，无需 Adobe Photoshop。
用于 PSD/PSB 文件的开源 Python 库
Aspose.PSD FOSS for Python 是一个免费、MIT 许可证的纯 Python 库，用于加载、检查，
并保存 Adobe Photoshop PSD 和 PSB 文件，无需 Adobe Photoshop 或任何
专有运行时。它提供了一个轻量级、独立的 API，以
PsdImage 和
Layer 为核心，让 Python 开发者能够以编程方式访问 PSD 文档的结构，而无需
本地依赖进行编译。该库读取 PSD/PSB 文件的尺寸、颜色模式、位深度和压缩
方式，并通过 PsdImage.layers 暴露每个图层：每个 Layer 报告其名称，
边界、不透明度、可见性以及混合模式键（BlendMode），以及更底层的
通道信息（ChannelInformation）和蒙版数据（LayerMaskData）。可以对
部分图层元数据——名称、边界（left/top/right/bottom）和混合模式——进行
就地修改并使用 PsdImage.save() 持久化回磁盘；其余内容在此 FOSS 构建中设计为只读。Aspose.PSD FOSS for Python 采用 MIT 许可证。使用
pip install aspose-psd-foss — 该库没有任何第三方本地
依赖，仅依赖 Python 标准库。企业产品系列请参阅 Aspose.PSD — Enterprise Product Family。加载并检查 PSD/PSB 文件
Image.load(file_path)打开文件并返回一个PsdImage实例PsdImage.width、height和channels_count报告画布尺寸和通道数- 文档头部细节从解析文件的颜色模式和压缩元数据中读取
PsdImage.layers返回文档顺序中的完整Layer对象列表
验证并编目设计文件
- 在将设计文件批量交给下游流程之前进行验证
- 构建 PSD/PSB 尺寸和图层计数的轻量资产目录
- 检测需要不同处理方式的 PSB（大文档）文件，而非标准 PSD
使用图层
PsdImage.layers返回文档顺序中的每个Layer；每个Layer公开name、bounds、opacity、is_visible和blend_mode_keyLayer.channel_information公开用于更深入检查的通道元数据Layer.channels_count报告层携带了多少图像通道PsdImage.layers本身可以重新赋值，以删除或重新排序层
审计层结构
- 在不打开 Photoshop 的情况下审计 PSD 的图层结构
- 为设计评审生成图层名称、可见性和混合模式的报告
- 识别早期编辑遗留下来的隐藏或零不透明度图层
编辑基本图层元数据
- 可以直接设置
Layer.name、Layer.left/top/right/bottom和Layer.blend_mode_key PsdImage.save(file_path)将修改后的文档持久化回磁盘- 使用
PsdImage.load重新加载已保存的文件，可确认编辑正确往返 - 如果设置上述未列出的属性（通道信息、蒙版数据、混合范围），将抛出
NotSupportedException—— 此构建仅支持元数据编辑，不支持完整的重新创作
轻量级、可脚本化编辑
- 将图层以编程方式重命名，作为自动化文件组织流水线的一部分
- 在不使用设计工具的情况下重新定位或调整图层边界框的大小
- 批量更新多个文件中的混合模式以保持一致性
检查通道和资源数据
Layer.channel_information暴露每个通道的元数据集合Layer.has_mask_data和has_blending_ranges_data报告是否存在可选章节PsdLoadException和PsdSaveException以清晰的消息显示加载/保存错误- 所有类都是纯 Python，没有编译的扩展模块
诊断和检查
- 诊断特定 PSD 文件加载失败的原因，使用特定异常而不是通用错误
- 检查图层在处理前是否携带掩码或混合范围数据
- 检查每个通道的元数据以进行格式级别的诊断
加载 PSD 文件并检查其图层
使用 Image.load 加载文件，以获取用于 PSD 特定成员的 PsdImage 实例。
from aspose_psd_foss.image import Image
with Image.load("test.psd") as image:
print(f"Width: {image.width}, Channels: {image.channels_count}, Layers: {len(image.layers)}")
编辑图层边界和混合模式，然后保存
图层的边界和混合模式可以就地更改并保存回磁盘。
from aspose_psd_foss.psdimage import PsdImage
from aspose_psd_foss.layers.blendmode import BlendMode
with PsdImage.load("test.psd") as image:
image.layers[0].left = 10
image.layers[0].top = 20
image.layers[0].right = 40
image.layers[0].bottom = 60
image.layers[0].blend_mode_key = BlendMode.MULTIPLY
image.save("edited.psd")
with PsdImage.load("edited.psd") as reloaded:
print(f"Bounds: {reloaded.layers[0].bounds}, BlendMode: {reloaded.layers[0].blend_mode_key}")
读取通道信息（只读）
频道信息可以读取，但不能重新赋值——尝试设置它会引发 NotSupportedException。
from aspose_psd_foss.psdimage import PsdImage
with PsdImage.load("test.psd") as image:
layer = image.layers[0]
channel_information = layer.channel_information
print(f"Channel count: {layer.channels_count}, first channel: `NotSupportedException`")
# layer.channel_information = channel_information # raises NotSupportedException
常见问题
许可模式是什么？
Aspose.PSD FOSS for Python 是 MIT 许可证下发布的。您可以在 MIT 许可证的条款下使用、修改和重新分发它，包括在商业产品中。
我该如何安装 Aspose.PSD FOSS for Python？
请参阅上面的安装章节，以获取当前的安装命令。
哪种格式可以 Aspose.PSD FOSS for Python 读取和写入？
它加载和保存 PSD 和 PSB（Photoshop 大型文档）文件。它不渲染或导出像素数据到其他栅格格式，如 PNG 或 JPEG。
主要入口类是什么？
PsdImage（Image的子类）。使用 PsdImage.load 加载文档，然后读取其 layers 集合和头部属性。
我可以修改图层元数据吗？
是的 — Layer 为多个属性（如可见性和名称）公开了可用的 setter，PsdImage.layers 本身也提供了用于替换集合的 setter。少数特定属性（通道信息、蒙版数据、混合范围以及一些文档级资源）在此 FOSS 构建中为只读，若尝试设置会抛出 NotSupportedException。
