composer 包名中的斜杠和点号无需转义，直接使用即可；需转义的是 shell 元字符（如空格、$、*），应单引号包裹；@ 符号属版本分隔符，不可用于包名；windows 路径推荐用正斜杠并省略冒号。
Composer 安装含斜杠或点号的包名时，不需要转义
Composer 的 require 命令和 composer.json 中的包名（如 monolog/monolog、psr/log）天然支持斜杠 / 和点号 .，它们是命名空间分隔符或组织标识符，不是 Shell 或 JSON 的特殊字符。你直接写就行，不用加反斜杠、引号或 URL 编码。
常见错误是看到包名里有 / 就下意识想转义，比如写成 monolog/monolog 或 "monolog/monolog" —— 这在 composer.json 里反而会报错，因为 JSON 字符串本身不解析反斜杠转义，而双引号是合法但非必需的；在命令行里加引号也纯属多此一举，除非你本地 Shell 环境真在路径里做了别名干扰（极罕见）。
-
composer require monolog/monolog✅ 正常执行 -
composer require "monolog/monolog"✅ 也能用，但没必要 -
composer require monolog/monolog❌ Shell 可能报 command not found，或被解释为字面量monolog/monolog（反斜杠被丢弃），无实际作用 - 在
composer.json中写"monolog/monolog": "^3.0"❌ JSON 解析失败：预期字符串结束，遇到
包名含空格、美元符、星号等 Shell 元字符时，必须用单引号包裹命令
真正需要处理的不是 Composer 包名本身，而是你在终端输入命令时，Shell 对某些字符的提前解析。比如包名里出现空格（极少见，但私有仓库或测试包可能有）、$、*、!、` 等，Shell 会试图展开或执行它们，导致命令根本传不到 Composer。
这时唯一可靠的方式是用单引号把整个包名参数括起来，让 Shell 完全按字面量传递：
-
composer require 'myorg/my-package-with-space'✅ 空格不被拆分 -
composer require 'vendor/name$dev'✅$dev不被当作环境变量展开 -
composer require "vendor/name*"❌ 双引号下*仍可能被 glob 展开（取决于 shell 设置） -
composer require vendor/name*⚠️ 可行但易错：需对每个元字符单独转义，且不同 shell 行为不一致
私有仓库中包名含 @ 符号（如 git@github.com:user/repo）不能直接当包名用
@ 在 Composer 里有特殊含义：它用于指定版本约束（如 monolog/monolog:2.10.0），而不是包名的一部分。如果你看到类似 git@github.com:user/repo 的字符串，这其实是 VCS 仓库地址，不是 Composer 包名。强行把它塞进 require 会导致 Could not find package git@github.com:user/repo 错误。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
正确做法是：先在 composer.json 的 repositories 中声明该仓库，再用标准命名（如 user/repo）引入：
{
"repositories": [
{
"type": "vcs",
"url": "git@github.com:user/repo"
}
],
"require": {
"user/repo": "dev-main"
}
}
注意：user/repo 必须与该仓库中 composer.json 文件里定义的 name 字段完全一致——这个 name 才是 Composer 认可的“包名”，它不能含 @、空格或控制字符，否则安装阶段就会拒绝加载。
Windows 下路径类包名（如 ../local/package）要用正斜杠且避免盘符冒号歧义
当你用 path repository 引入本地包，路径中若含 Windows 盘符（如 C:path opkg），直接写会导致 Composer 解析失败：冒号 : 被当成版本分隔符， 在 JSON 或命令行中容易被转义混乱。
解决方案很直接：统一改用正斜杠 /，并省略盘符后的冒号（Composer 内部会自动适配）：
-
"../my-local-pkg"✅ 相对路径，安全通用 -
"C:/projects/my-pkg"✅ Windows 上可用，冒号不触发版本解析 -
"C:projectsmy-pkg"❌ 反斜杠在 JSON 中需双写为\，且部分 shell 会吃掉第一个 -
"C:/projects/my-pkg:dev-main"❌ 冒号后内容会被误判为版本，应移至require的 value 字段
最稳妥的做法始终是把本地包放到项目同级目录，用 ../xxx 形式引用，避开所有平台相关字符问题。
