如何重命名create-react-app顶层文件夹且不会引发冲突？

核心结论 #

仅修改Create React App生成的项目顶层文件夹名称，不会破坏依赖结构，也基本不会引发日常开发、部署问题，你当前没遇到问题属于正常情况，不需要过度担心。

原因说明 #

• npm要求包名小写的限制，仅针对要发布到npm公共仓库的包的package.json内name字段，你本身不打算发布npm包，这个限制对你完全不生效。
• 项目的依赖安装、构建逻辑全部基于项目根目录下的package.json、node_modules和内部文件的相对路径，只要你重命名顶层文件夹后，内部的文件相对路径没有改动，npm/yarn/pnpm的依赖解析、CRA的构建逻辑都不会受影响。

需要注意的潜在边缘问题 #

只有以下少数特殊场景可能出问题，提前规避即可：

• 如果团队里同时有用Windows（默认文件系统大小写不敏感）和macOS/Linux（默认大小写敏感）的开发人员，要确保所有人在引用项目路径、配置部署路径的时候大小写统一，避免出现本地Windows运行正常，部署到Linux服务器找不到路径的情况。
• 配置部署时，如果Web服务器的站点根目录路径填写了大写的文件夹名，要确保客户端路由的基础路径（package.json的homepage字段、BrowserRouter的basename属性）和服务器配置的路径大小写完全一致，否则会出现路由404。
• 不要在修改顶层文件夹名的同时，随意修改src下的文件/文件夹大小写，CRA默认的构建逻辑对src内的文件路径大小写敏感，写错会导致模块引用报错。

你之前看到的相关讨论里提到的大小写敏感限制，核心都是针对要发布的npm包名、以及代码内的模块引用路径，和你本地项目的顶层文件夹名称没有关系，不需要套用到当前场景。

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