⚠️ Alpha内测版本警告:此为早期内部构建版本,尚不完整且可能存在错误,欢迎大家提Issue反馈问题或建议
Skip to content

待开发

11.3 协作问题诊断与解决

跨平台协作三原则

当 Windows、Mac、Linux 用户一起开发时,注意以下问题:

1. 配置 .gitignore

防止把不该提交的文件上传到仓库:

绝对不能提交

  • node_modules/ - 依赖包(体积大、平台相关)
  • .env 文件 - 包含密钥和敏感信息
  • 系统垃圾文件(.DS_StoreThumbs.db

告诉 AI:"为我的项目生成合适的 .gitignore 文件"

2. 换行符统一

不同系统的换行符不同,会导致"假 diff"(显示整文件都改了,实际内容没变):

告诉 AI:"配置 Git 自动处理换行符"

3. 路径分隔符

永远使用正斜杠 /

javascript
// ✅ 正确
import { Button } from 'src/components/Button';

// ❌ 错误 - Windows 反斜杠在代码中会出错
import { Button } from 'src\\components\\Button';

冲突解决

当多人修改同一文件的同一位置时,Git 无法自动合并,产生冲突。

解决步骤

  1. 告诉 AI:"解决这个 Git 冲突"
  2. 把包含冲突标记的文件内容发给 AI
  3. 说明优先保留哪一方的逻辑
  4. AI 会返回合并后的代码
  5. 再次提交即可

冲突标记示例

<<<<<<< HEAD
你的修改
=======
远程的修改
>>>>>>> branch-name

常见协作问题速查

问题原因告诉 AI
推送失败远程有新提交"先拉取最新代码,解决冲突后再推送"
文件找不到大小写问题"统一文件名使用小写"
整文件显示修改换行符问题"配置 Git 处理换行符"
node_modules 被提交未配置 .gitignore"从仓库删除并忽略 node_modules"