composer.json 中文描述字段无需手动转义，但必须保存为无bom的utf-8编码，且仅使用半角标点和双引号包裹的合法json字符串；name字段须为ascii-only，否则packagist拒绝同步。
Composer.json 中中文描述字段是否需要转义
不需要手动转义，但必须确保文件保存为 UTF-8 编码且无 BOM。Composer 原生支持 UTF-8，description、name、keywords 等字段可直接写中文，只要 JSON 语法合法即可。
常见错误是用记事本保存导致 BOM 头污染，或混用全角标点（如“，”“。”）引发解析失败——JSON 只认半角符号。
- 用 VS Code、PhpStorm 或 Sublime Text 保存时，右下角确认编码显示 UTF-8，不是
UTF-8 with BOM - 避免在
description里写换行符，JSON 不允许未转义的换行；如需换行，用\n并确保字符串用双引号包裹 - 全角空格、中文冒号（：）、中文引号（“”）会直接导致
composer validate报错：JSON decode error: Syntax error
验证中文字段是否被正确识别
运行 composer validate 是最直接的检验方式。它会检查 JSON 结构和字段语义，但不会校验语言内容本身——只要不报错，说明中文已成功加载。
进一步确认可执行：composer show --no-dev | grep description，观察输出是否为预期中文。若显示乱码，问题一定出在文件编码，而非 Composer 配置。
-
composer validate成功 ≠ 中文能正常显示在 Packagist 页面，后者还依赖name字段是否符合命名规范（见下一条） - 如果
description含 URL 或邮箱，注意仍需保持标准格式，例如"访问官网：https://example.com"是合法的，但"访问官网：https://例.com"可能触发 Packagist 的域名校验失败
Packagist 显示中文描述失败的真正原因
Packagist 对 name 字段有严格限制：必须是小写字母、数字、连字符或下划线，且不能含中文。但很多人误以为 description 显示异常是因为它本身有问题，其实根本原因是 name 不合法导致整个包元数据被拒绝同步。
-
name字段必须形如vendor/package-name，其中vendor和package-name都只能含 ASCII 字符 -
description写得再规范，只要name是张三/my-app或my-中文-app，Packagist 就不会拉取该字段 - 中文项目名建议用拼音或英文缩写，例如
zhangsan/blog-system，然后在description里写清楚「这是一个基于 Laravel 的博客系统（中文版）」
带中文的 keywords 字段怎么写才不被忽略
keywords 是字符串数组，每个元素必须是纯字符串，不能含逗号分隔——那是人为拆分逻辑，不是 JSON 语法要求。中文关键词直接写进数组即可，但要注意 Packagist 搜索对非 ASCII 关键词支持有限。
- 写法正确：
"keywords": ["博客", "cms", "php"]；错误写法："keywords": ["博客,cms,php"]（这会被当做一个关键词） - Packagist 搜索主要匹配
name和英文description，中文keywords几乎不影响搜索排序，仅作元数据记录用途 - 若想提升中文用户检索命中率，优先在
description开头嵌入高频词，比如"博客系统，支持多语言，基于 Laravel 10 开发..."
真正卡住中文项目上线的，往往不是 description 本身，而是 name 违反 Packagist 的 ASCII-only 规则，或者文件编码藏了 BOM 却没意识到——这两个点查起来快，改起来也快，但容易反复踩。
