下载 PhotoCraft Windows 版：安装教程

PhotoCraft 的 Windows 版有两种形式：带代码签名的 MSI 安装包和免安装的便携版 zip，各自提供 x64、ARM64 和 32 位 x86 三种架构。绝大多数电脑选 x64 的 MSI 即可。上方表格里的每个文件都直接链接到 GitHub 官方发布页。PhotoCraft 目前仍是早期 alpha 版本，功能和稳定性都还在快速变化。

该下载哪个文件

你的电脑	选择
普通 64 位 Intel / AMD 电脑	photocraft-<版本>-windows-x64.msi
骁龙等 ARM 电脑	photocraft-<版本>-windows-arm64.msi
32 位 Windows	photocraft-<版本>-windows-x86.msi
没有管理员权限、想放 U 盘、或只是想先试试	对应架构的 -portable.zip

MSI 还是便携版？ MSI 为整台电脑安装到 Program Files，创建开始菜单快捷方式，把 .pcraft 文件默认关联到 PhotoCraft，并把它加入 PSD、PSB 和常见图片格式的“打开方式”列表（不会抢占你原有的默认程序），还会注册 photocraft 命令，可以在 Win+R 运行框里直接启动。便携版不改动系统：压缩包里带有一个 portable.txt，有它在，PhotoCraft 会把首选项、预设和崩溃恢复的自动保存放进 exe 旁边的 PhotoCraftData 文件夹，而不是 %APPDATA%\Photocraft。

系统要求： 发布版面向 Windows 10 及以上。两种格式都静态链接了 C 运行库，不需要另装 Visual C++ 运行库。PhotoCraft 通过 wgpu 用 GPU 绘制画布（Vulkan 或 DirectX 12），GPU 路径失败时会退回 CPU 渲染（WARP）。

不确定自己是哪种架构？打开“设置 › 系统 › 系统信息”，看“系统类型”一栏。

用 MSI 安装

1. 从上方表格下载对应架构的 .msi。
2. 建议先校验文件（见下文）。
3. 双击 MSI。安装程序没有向导页面，只显示进度条，固定安装到 Program Files\PhotoCraft（在 64 位系统上装 32 位版本时为 Program Files (x86)\PhotoCraft），不能自选目录。
4. 从开始菜单启动，或按 Win+R 输入 photocraft。

官方 README 写明安装包和可执行文件都做了代码签名。如果 SmartScreen 仍对新下载的文件弹出提示，可以先在文件“属性 › 数字签名”里确认签名有效再运行。没有签名的“PhotoCraft 安装包”不是官方发布的。

需要批量部署的管理员可以用标准 MSI 参数静默安装：

msiexec /i photocraft-0.5.0-windows-x64.msi /qn

使用便携版

1. 下载 -portable.zip，把整个文件夹解压到你有写入权限的位置（用户目录或 U 盘，不要放进 Program Files）。
2. 运行 photocraft.exe。

保持 portable.txt 和 exe 在一起即可维持便携模式。如果 PhotoCraftData 无法写入（比如在只读盘上），PhotoCraft 会提示并改用 %APPDATA%\Photocraft。删除 portable.txt 就会回到普通的用户设置目录。

校验下载文件（SHA256）

每个版本都附带 SHA256SUMS.txt，列出所有文件的校验值。把它和安装包下载到同一文件夹，然后在 PowerShell 里计算：

Get-FileHash .\photocraft-0.5.0-windows-x64.msi -Algorithm SHA256

或在命令提示符里：

certutil -hashfile photocraft-0.5.0-windows-x64.msi SHA256

结果要和 SHA256SUMS.txt 里对应文件那一行一致（不区分大小写）。也可以让 PowerShell 直接比对：

$file = "photocraft-0.5.0-windows-x64.msi"
$expected = (Select-String -Path .\SHA256SUMS.txt -SimpleMatch $file).Line.Split(' ')[0]
(Get-FileHash $file -Algorithm SHA256).Hash -eq $expected

输出 True 表示文件完整。请把 0.5.0 和架构换成你实际下载的文件名。

命令行工具 photocraft-cli

Windows 没有单独的 CLI 下载包：MSI 和便携版都在 photocraft.exe 旁边带了 photocraft-cli.exe。MSI 不会把它加入 PATH，所以要用完整路径调用，或者自己把安装目录加进 PATH：

& "C:\Program Files\PhotoCraft\photocraft-cli.exe" --version
& "C:\Program Files\PhotoCraft\photocraft-cli.exe" batch --help

photocraft --version、photocraft-cli --version 以及 帮助 › 关于 PhotoCraft（Help › About PhotoCraft）都会显示版本号、提交号和构建日期。

更新

• MSI： 下载新版 MSI 直接运行，会原地升级。用旧版 MSI 覆盖新版会被拒绝。
• 便携版： 解压新版 zip，把旧的 PhotoCraftData 文件夹复制过去即可保留设置。

截至 v0.5.0，PhotoCraft 还没有内置的检查更新功能（计划见 #220）。可以关注本站的版本更新或 GitHub 发布页。

winget： 官方 winget 仓库里还没有 PhotoCraft。相关请求是 #1233（未关闭），社区向 microsoft/winget-pkgs 提交的包（如 #448577）截至 2026 年 10 月 9 日都还没有合并，所以现在 winget install 找不到 PhotoCraft。

卸载

• MSI： 设置 › 应用 › 安装的应用 › PhotoCraft › 卸载，或执行 msiexec /x photocraft-0.5.0-windows-x64.msi。
• 便携版： 直接删除文件夹。

首选项保存在 %APPDATA%\Photocraft（MSI 安装）或 PhotoCraftData（便携版）。想彻底清理的话把它一起删掉。

Windows 上的已知问题

Intel 显卡启动即崩溃（Vulkan）：#4，未关闭。部分 Intel 核显会在 Intel Vulkan 驱动（igvk64.dll）内部崩溃。从 v0.3.0 起，PhotoCraft 在创建 GPU 设备前会写下一个标记文件：如果某次启动死在驱动里，下次启动会自动按 Vulkan › DX12 › CPU 的顺序降级，并记住可用的选择；Intel 显卡默认已改用 DX12。如果仍然打不开，可以手动指定一次后端：

$env:WGPU_BACKEND = "dx12"
& "C:\Program Files\PhotoCraft\photocraft.exe"

或者用 CPU 渲染启动一次：

& "C:\Program Files\PhotoCraft\photocraft.exe" --safe-gpu

记住的选择可以在 首选项 › 性能 › GPU 后端（Preferences › Performance › GPU Backend）里查看，点“重置 GPU 后端”（Reset GPU Backend）恢复默认。帮助 › 系统信息（Help › System Info）会显示正在使用的显卡、后端和驱动版本，提交问题时附上这些信息最有用。

DX12 下打开 PSD 崩溃（加载了别的程序的 dxcompiler.dll）：#712，已关闭。v0.5.0 已修复，不再加载 PATH 里找到的 dxcompiler.dll。旧版本用户请升级。

压感： Windows 上数位板压感可用，缺压感的是 macOS 和 Linux（#79）。

更多问题见故障排除。

只从 GitHub 官方下载

photocraft.im 是非官方的社区指南，本站所有下载链接都指向官方 storytold/photocraft GitHub 发布页；官方也推荐新用户从 getartcraft.com 的 PhotoCraft 页面下载。请不要使用其他渠道重新打包的安装包。

例如 awpde/photocraft-zh 发布了一个“简体中文版” MSI，它是从开发分支自动编译的，并不对应正式发布版本，作者自己也说明安装包没有代码签名。其实完全不需要它：官方安装包本身就内置简体中文界面，语言设为“自动”时会跟随系统语言，切换方法见界面语言设置。