新手必看：React团队协作 | 5分钟学会

▌ 技术引导
React团队协作中最大的陷阱在于状态管理的混乱。我见过无数项目因为没统一状态管理方案，导致组件间通信像蜘蛛网一样缠绕，调试比拆炸弹还难。真正值得一看的是如何用Redux Toolkit结合RTK Query构建可维护的API层，还有如何用immer优化不可变数据的更新。别傻乎乎地搞单文件组件传props，那样只能把代码写成屎山。用Context API或者Provider模式，直接把状态举到最顶层。别问为什么，问就是我亲测过，这玩意儿把团队协作效率拉到天花板。

要让团队协作顺畅，必须用Git的子模块或Monorepo结构管理多项目。别用全局安装命令，直接在项目根目录用npm install react react-dom，前提是你用的是npm 8+，否则会卡在版本锁。远程仓库配置上，别用默认的origin，改成更清晰的命名，比如team-repo，这样大家拉代码时不会搞混。别自动合并，手动解决冲突，这能避免半夜被代码杀死。

用VS Code的Git集成和Remote Explorer插件能大幅提升协作体验，尤其是多人同时修改同一文件时。我在工作中发现，用Git LFS管理大文件会比用普通git更稳定，尤其是在处理图片或二进制数据时。用yarn workspaces会比npm workspaces更高效，尤其是在多项目共享依赖时。别用eslint配置文件，用prettier和husky结合，能自动格式化代码并拦截提交错误。

团队协作必须有清晰的分支策略，比如Git Flow或者Trunk-Based Development。别用feature分支去搞大改动，直接在main分支上开发，这样能减少合并冲突。如果用TypeScript，记得加--strict参数，至少能提前发现90%的类型错误。别用全局状态，用局部状态加自定义Hook封装数据逻辑，这样组件复用性更强，维护成本更低。用storybook写组件文档，而不是写README，这样文档和代码同步，不会过时。

用Jest写单元测试时，别用npm install jest，直接用yarn add jest -D，因为yarn的缓存机制更稳定。别用空的test文件，直接在每个多态组件里写test case，这样能确保覆盖率。用React Testing Library代替Enzyme，因为它是真实渲染，更符合前端实际运行环境。别用console.log调试，用React Developer Tools的组件树和网络面板，效率翻倍。用CRUD模式开发，别搞什么神秘的架构，直接按照业务模块拆分，这比写一堆理论文档落地快太多了。

▌ 技术参考
一 React团队协作的核心矛盾在于组件状态的共享和隔离。我见过太多项目把状态写在组件内部，结果多个组件之间像拆盲盒一样互相插脚。真正行之有效的方式是把状态举到最顶层，用Context API或者Redux Toolkit做统一管理。别直接在组件里写useContext，要用useSelector和useDispatch，这样能避免不必要的重新渲染。使用immer库可以简化不可变对象的更新，比如用produce函数替代对象克隆，这能减少90%的冗余代码。

二 在React项目中使用Redux Toolkit时，必须确保配置正确。记得在store.js里用createStore和configureStore结合，别直接用createStore。用combineReducers合并多个reducer文件，这样模块化更清晰。别用默认的dispatch函数，直接导入useDispatch并绑定到组件，这样能避免类型错误。RTK Query的baseQuery配置一定要带上credentials: 'include'，否则跨域请求会出错。用queryCache和mutationCache控制缓存策略，确保网络请求不会被重复调用。

三 Git分支策略对团队协作至关重要。我见过太多项目用feature分支搞大改，结果main分支被破坏，大家都要回滚。正确的做法是用Trunk-Based Development，所有开发都在main分支上进行，这样减少合并冲突。别用默认的origin，改成更明确的命名，比如team-repo，避免多人提交时的混乱。用git rebase而不是merge，保持提交历史干净。别用git push -f，除非你确定要覆盖历史，否则会导致他人分支出问题。

四 用VS Code配合Git和Remote Explorer插件能显著提升协作效率。在团队协作中，别用全局安装的插件，直接在项目根目录用npm install -D eslint prettier，这样配置更灵活。用.gitignore文件排除node_modules和dist目录，防止提交混乱。别用空的test文件，直接在每个多态组件里写test case，确保覆盖率。用VS Code的Diff视图对比提交记录，避免误删代码。用Remote Explorer连接远程仓库，这样多人协作时能实时看到提交变化。

五 模块化开发是React团队协作的基石。在项目中用yarn workspaces或lerna管理多个子项目，这样依赖管理更清晰。别用全局安装，直接在项目根目录用yarn add -W react react-dom，这样每个子项目都能独立管理版本。用tsconfig.json配置模块解析路径，避免import路径混乱。别用路径别名搞复杂，直接用相对路径更稳定。用TypeScript能提前发现90%的错误，别用JavaScript，除非你确定能自己处理类型问题。

六 在多人协作时，必须用husky配置pre-commit钩子。别用npm install husky，直接用yarn add husky -D，因为yarn的钩子更稳定。用lint-staged配置git add后自动格式化代码，比如用Prettier和ESLint结合，这样提交前就能确保代码风格一致。别用空的commit信息，强制要求每个人提交时写明issue编号和修改内容。用git commit --amend能快速修改提交信息，别用git commit -am，这样会把所有未提交的更改都包含进去。

七 用React Testing Library写测试时，必须注意模拟交互的方式。别用expect(wrapper.find()).toBe，直接用screen.getByText()获取元素，这样更符合真实用户视角。用userEvent库模拟点击和输入，而不是直接调用fireEvent，这样能保证测试更真实。别用Jest的mock函数直接替换API，用RTK Query的mocked API配置更高效。用test-utils创建自定义测试组件，这样能减少重复代码。别用console.log调试测试结果，直接用expect和toThrow断言。

八 在React项目中，别用全局状态，而是用自定义Hook封装数据逻辑。比如用useAuth封装登录状态，这样多个组件可以复用。用useState和useEffect控制组件生命周期，别用类组件，除非你遇到性能问题。用useContext简化状态传递，但别滥用，否则组件树会变得像爬虫一样复杂。用Redux Toolkit结合Redux DevTools，这样能实时看到状态变化。用React.memo优化组件性能，避免不必要的渲染。

九 用Jest进行单元测试时，必须配置正确的环境变量。比如在jest.config.js里设置testEnvironment: 'jsdom'，这样能模拟浏览器环境。别用默认的testMatch，改成testMatch: ['/?(.)(test).jsx']，确保只运行测试文件。用setupFilesAfterEnv配置环境变量，比如process.env.NODE_ENV = 'test'，避免生产环境配置被误用。用testPathIgnorePatterns排除不必要的文件，比如dist、node_modules。用watchMode和testResultsPath快速定位失败用例。

十 在多人协作中，使用Git LFS管理大文件是关键。别用普通git提交图片或视频，直接用git lfs install并配置.gitattributes文件，这样大文件能被正确跟踪。用git lfs push上传文件，确保多人能拉取到相同版本。别用SSH连接，用HTTPS更稳定，尤其是团队成员频繁切换设备时。用git diff查看文件变化，避免误提交。用git blame查看代码是谁修改的，帮助追溯问题源头。别用git reset --hard，改用git reset --mixed这样能保留修改记录。

十一 在React项目中使用TypeScript时，必须配置tsconfig.json文件。别用默认的moduleResolution，改成node，确保模块解析正确。用strict模式能提前发现90%的类型错误，别关闭。用paths配置别名，比如@/components，这样import路径更清晰。用type-checker配合pre-commit钩子，确保提交前不提交类型错误。别用空的type定义，直接用interface或type别名。用JSDoc注释提升代码可读性，别写一堆无意义的注释。

十二 用Storybook编写组件文档时，必须配置正确的webpack和babel。别用默认的配置，直接在.config.js里加stories和addons配置。用@storybook/addon-actions和@storybook/addon-knobs让文档更真实。别用空的story文件，直接在components目录下创建story.js文件，每个组件一个story。用jsx文件写文档，而不是md，这样能实时预览效果。用preview.js统一配置文档样式，别每个组件都写一遍。用react-docgen-typescript解析TypeScript类型，让文档更智能。

十三 在React项目中，别用全局安装的工具，直接在本地用npm install -D eslint prettier，这样配置更灵活。用ESLint配置文件里加react和typescript插件，确保代码符合规范。别用空的ESLint规则，直接用airbnb或prettier的配置，这样团队风格统一。用Prettier配置trailingComma和printWidth，确保代码格式一致。别用yarn install，直接用yarn add，避免版本混乱。用yarn workspaces管理多个子项目，这样依赖更清晰。

十四 在团队协作中，使用CI/CD工具是必须的。别用空的CI配置，直接在GitHub Actions或GitLab CI里加test和build阶段。用Jest和TypeScript检查代码质量，别省略。用lerna或yarn workspaces运行所有测试，确保整个项目通过。别用空的build脚本，直接用npm run build或者yarn build，这样能生成生产环境代码。用docker运行测试环境，确保不同设备上的结果一致。别用本地测试，直接用CI确保可部署。

十五 用React DevTools调试时，别用简单的console.log，直接用component tree和network面板。用Redux DevTools查看状态变化，别用普通日志，这样能快速定位问题。用React Developer Tools的props和state面板，避免手动遍历代码。别用空的组件状态，直接用useState和useReducer管理。用Component Inspector检查组件渲染情况，防止隐藏元素。别用浏览器的开发者工具，直接用React DevTools，这样效率更高。