post-install-cmd中直接用cp复制含中文路径资源会失败，因linux/macos下cp -r在非utf-8 locale中无法识别中文路径，需显式设置lang=en_us.utf-8、统一用英文路径、避免中文包名及目录名，并优先使用php脚本配合mb_convert_encoding处理编码。
post-install-cmd 中直接用 cp 复制含中文路径的资源会失败
Linux/macOS 下 cp -r 默认不支持 UTF-8 路径中的中文字符（尤其在某些 locale 配置为 C 或 POSIX 的 CI 环境），脚本执行时可能静默跳过或报错 cp: cannot stat ‘xxx’: No such file or directory，而 Composer 不提示具体原因，只显示安装中断。
- 必须显式设置 locale：在脚本开头加
export LANG=en_US.UTF-8或export LC_ALL=C.UTF-8（确保系统已安装对应 locale） - 路径不能硬编码中文名，应统一用英文别名替代，例如把
vendor/某公司/组件/dist映射为vendor/some-company/component/dist—— 包作者若未提供英文name字段，Composer 无法解析中文命名空间 - 若必须处理用户上传的含中文路径资源（如
public/产品文档/），不要放在post-install-cmd中搬运；改用部署后脚本或 Web 端逻辑处理，避免 Composer 生命周期介入
asset-packagist.org 不支持中文包名或中文路径配置
asset-packagist.org 只识别标准 npm/bowser 命名规范：npm-asset/bootstrap、bower-asset/jquery。它不接受 npm-asset/某某组件 这类含中文的包名，请求会 404；同时 extra.asset-installer-paths 中的路径值（如 "public/前端库"）虽能写中文，但插件内部使用 file_put_contents() 写入时可能因 PHP 默认编码非 UTF-8 导致乱码或创建失败。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 路径配置一律用英文：例如
"public/assets/bootstrap"，而非"public/样式库/bootstrap" - 确认 PHP 环境默认编码为 UTF-8：
@php -r "echo mb_internal_encoding();"应输出UTF-8；否则在post-install-cmd中加@php -r "mb_internal_encoding('UTF-8'); ..." -
fxp/composer-asset-plugin已停止维护，新项目建议改用php-assets/composer-installers，后者对多字节路径兼容性略好，但仍不推荐路径含中文
PHP 脚本搬运比 shell 更可控，但需注意 fopen 编码
用 post-install-cmd 调用 PHP 脚本复制文件，可绕过 shell 的 locale 限制，但 fopen()、copy() 等函数在 Windows 和部分 Linux 发行版上对中文路径支持不稳定，尤其是目标路径含中文时易触发 failed to open stream: No such file or directory。
- 优先使用
dirname()+mkdir()+copy()组合，且对每个路径调用前用mb_convert_encoding($path, 'UTF-8', 'auto')强制转码 - 避免
scandir()直接读取含中文子目录：改用glob("{$src}/*")并配合mb_regex_encoding('UTF-8')（需启用 mbstring 扩展） - Windows 环境下，路径分隔符必须用
\或/，不能混用；realpath()对中文路径返回 false 是常见现象，应改用__DIR__ . '/public/xxx'拼接绝对路径
真正该问的是：为什么静态资源路径要含中文？
Web 服务器（Nginx/Apache）、CDN、浏览器缓存机制、HTTP 协议本身对 URI 中的中文支持有限——即使你成功把文件拷到 public/产品介绍/，浏览器访问 /产品介绍/app.js 仍可能被编码为 %E4%BA%A7%E5%93%81%E4%BB%8B%E7%BB%8D/app.js，导致 404 或跨域问题。这不是 Composer 的锅，而是整个 HTTP 生态的约束。
- 所有对外暴露的静态资源路径，必须是 ASCII 字符（a–z、0–9、-、_、.）
- 中文语义应保留在 HTML 内容、meta 标签或 CMS 后台字段中，而非文件系统路径
- 如果业务强依赖中文路径（如多语言站点子目录），用 Nginx 的
alias或 Apache 的RewriteRule做映射，让物理路径仍是英文，URL 看起来像中文
