安装程序使用{userdocs}路径时报错：写入OneDrive而非本地用户磁盘

问题答疑 #

为何安装程序会尝试写入OneDrive目录而非本地文件夹？ #

Windows系统支持OneDrive接管「文档」「桌面」「图片」三类用户常用目录的自动备份，只要用户在OneDrive设置中开启了文档备份选项，系统级的用户文档目录路径就会被重定向到OneDrive的本地同步文件夹下。你所用的Inno Setup安装脚本中{userdocs}常量是直接调用Windows官方API读取系统文档目录路径，因此会直接拿到OneDrive对应的目录，写入操作自然会落到OneDrive路径下。

若OneDrive账号存储空间已满，为何会阻塞本地安装流程？ #

当文档目录被重定向到OneDrive同步目录后，该目录下的所有写入操作都会被OneDrive的实时同步逻辑拦截校验：新增文件或目录时，OneDrive会先校验云端存储空间是否足够容纳待同步的新内容，若云端已满，OneDrive会主动阻止新内容写入本地同步目录，避免出现本地与云端内容不一致的冲突，因此会直接导致安装写入操作被系统拒绝。
你遇到的错误123还有额外诱因：报错路径中的?????????是乱码标识，说明路径中存在当前系统编码不支持的特殊字符（比如非系统默认语言的文字、特殊符号、emoji等），也会直接触发目录创建失败。

{userdocs}常量是否有可能返回OneDrive对应的目录路径？ #

完全有可能，这是符合Windows系统设计逻辑的正常行为。{userdocs}本质是读取Windows Known Folder体系中FOLDERID_Documents的绑定路径，只要用户开启了OneDrive文档备份，系统就会主动修改该路径为OneDrive下的对应目录，{userdocs}会直接返回该值，不属于安装脚本的逻辑错误。

可选修复方案 #

• 若要强制写入非同步的本地用户目录，可改用{localappdata}常量存储应用相关的用户数据，避免触发OneDrive同步逻辑；
• 安装脚本中可新增路径合法性校验逻辑，提前检测目标路径是否存在特殊字符、是否有写入权限，提前拦截异常场景；
• 可在安装向导中新增自定义存储路径选项，允许用户自行选择文件存放位置，适配不同用户的系统配置。

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