Yarn Workspaces执行git clean -xdf时追踪文件被删除的问题求助

我之前碰到过这个棘手的问题，当时也困惑了好久——毕竟git clean的核心逻辑就是只清理未被Git追踪的文件，怎么会把已提交的文件删掉呢？结合你提到的Yarn仓库issue和可复现仓库，我来梳理下原因和可行的解决方案：

一、根本原因 #

这是Yarn Workspaces的一个已知bug，核心触发点是：
当你用Yarn Workspaces安装依赖后，Yarn会在根目录的node_modules下创建子工作区的符号链接（比如node_modules/workspace1指向../workspace1）。而git clean -xdf的-d参数会删除未被追踪的目录，这里Git误将子工作区的目录识别为“未被追踪的关联目录”——因为符号链接的存在，Git的索引出现了混淆，最终错误地删除了原本被追踪的子工作区文件。

简单说就是：Yarn创建的工作区符号链接干扰了Git对“已追踪目录”的判断，导致git clean -xdf出现了误操作。

二、临时解决方案 #

在官方修复这个bug之前，可以用以下几种方式规避：

1. 避免使用git clean -xdf的-d参数 #

如果不需要删除未追踪的目录，改用更安全的命令：

git clean -xf

这个命令只会清理未追踪的文件，不会处理目录，也就不会触发子工作区的误删问题。

2. 清理前先移除Yarn的工作区链接 #

在执行git clean之前，先手动删除根目录的node_modules：

rm -rf node_modules/
git clean -xdf

先移除符号链接，Git就能正确识别已追踪的子工作区目录，不会误删文件。

3. 临时配置Git忽略工作区符号链接（不推荐） #

在根目录的.gitignore里添加子工作区的符号链接路径：

node_modules/workspace1/
node_modules/workspace2/

这样Git会忽略这些符号链接目录，避免git clean时误判，但可能会影响Yarn Workspaces的正常工作，仅作为应急方案使用。

三、验证问题的方法 #

你可以在执行git clean前先查看Git对目录的识别状态：

git ls-files --stage workspace1/

如果能看到workspace1/index.js和workspace1/package.json的追踪记录，说明这些文件确实是被Git追踪的；而执行yarn install后再运行这个命令，可能会发现Git的索引出现异常，这就是Yarn导致的问题。

另外，你提供的git status输出也明确证明了这一点——原本被追踪的文件被标记为deleted，完全不符合git clean的预期行为。

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