Bitbucket代码仓库全流程指南：从创建到分支管理与忽略文件配置

1. Bitbucket项目创建与权限配置

第一次接触Bitbucket团队协作时，项目创建往往需要管理员权限。这里有个小技巧：如果你所在团队使用企业邮箱域（比如@company.com），通常可以直接用公司邮箱申请项目创建权限。我遇到过不少开发者卡在这一步，其实只要在Bitbucket右上角点击「Get help」联系支持团队，说明开发需求即可快速获得权限。

获得权限后，创建仓库的界面比想象中更简单。点击左侧导航栏的「Repositories」→「Create repository」，关键是要注意两个配置项：

• 项目类型：私有仓库（Private）默认勾选，适合商业项目
• 分支模型：建议勾选「Include a README」和「Git LFS」选项，前者自动生成基础文档结构，后者方便后续管理大文件

创建完成后，你会看到类似这样的HTTPS克隆地址：https://username@bitbucket.org/teamname/reponame.git。这里有个实际使用中的细节——地址中的username@部分在新版Bitbucket可以省略，系统会自动识别当前登录用户。

2. 本地开发环境初始化

第一次配置本地Git环境时，很多新手会忽略全局配置的生效范围。执行以下命令时：

git config --global user.name "Your Name" git config --global user.email "your.email@example.com"

这些信息会写入~/.gitconfig文件（Linux/Mac）或C:\Users\用户名\.gitconfig（Windows）。我在团队协作中遇到过因为邮箱格式不规范导致提交记录无法关联JIRA任务的情况，建议使用公司统一邮箱格式。

克隆仓库时有个实用技巧：在Bitbucket仓库页面点击「Clone」按钮，会显示带认证信息的完整命令：

git clone https://your_username@bitbucket.org/teamname/reponame.git

这样能避免每次操作都要重复输入密码。如果使用SSH方式克隆，记得先在「Settings」→「SSH keys」添加公钥。

首次提交代码时，推荐使用git add -A代替git add .，前者会捕获所有变更包括文件删除操作。提交信息（commit message）的规范也很重要，好的示例：

feat: 添加用户登录模块 - 实现JWT认证功能 - 增加登录页面UI组件

这种格式符合Conventional Commits规范，方便后续生成Change Log。

3. 分支管理实战技巧

查看全部分支时，git branch -a命令会显示红色标记的远程分支和白色标记的本地分支。创建新分支有个更高效的方式：

git checkout -b feature/new-module origin/develop

这条命令同时完成了三件事：基于远程develop分支创建本地分支、命名新分支为feature/new-module、自动切换到这个新分支。

在实际项目中，我推荐使用这种分支命名约定：

• feature/：新功能开发
• bugfix/：缺陷修复
• hotfix/：紧急线上问题修复
• release/：版本发布准备

推送新分支到远程时，git push -u origin branch_name中的-u参数特别重要，它建立了本地分支与远程分支的追踪关系，之后在这个分支上只需输入git push即可。

4. 分支合并的避坑指南

合并master分支到特性分支是日常高频操作，但直接使用git merge master可能会带来意外冲突。更安全的操作流程应该是：

git fetch origin # 先获取远程最新变更 git rebase origin/master # 变基操作保持提交线整洁 git push --force-with-lease # 安全强制推送

如果遇到冲突，可以使用git mergetool调用可视化工具解决。有个容易忽略的细节：合并完成后，建议执行git prune清理本地缓存的远程分支引用。

对于长期存在的特性分支，建议每周至少同步一次master分支。我在实际项目中遇到过因为分支偏离主分支太久，最终合并时产生数百处冲突的惨痛案例。

5. .gitignore配置的深层理解

.gitignore文件的作用远比表面看起来复杂。它不仅忽略未跟踪文件，还会阻止已忽略文件被意外添加。查看文件是否被忽略可以使用：

git check-ignore -v path/to/file

对于前端项目，典型的忽略规则应该包括：

# 依赖目录 node_modules/ dist/ # 编辑器配置 .vscode/ .idea/ # 环境变量 .env *.local

有个高级技巧：如果想强制添加被忽略的文件，可以使用git add -f filename。对于已经提交到仓库的文件，需要先执行：

git rm --cached path/to/file

再将其添加到.gitignore才能生效。

6. 团队协作最佳实践

在多人协作项目中，推荐启用Bitbucket的「Branch permissions」功能，限制直接向master分支推送代码。同时开启「Required approvals」设置，确保代码必须经过至少一人审查才能合并。

代码审查时，善用「Pull request」的「Diff」视图。按住Alt键点击代码行可以直接添加评论，使用#符号可以关联issue。我习惯在描述中使用「Checklist」格式：

- [ ] 完成单元测试 - [ ] 更新API文档 - [ ] 验证移动端兼容性

对于频繁出现的合并冲突，可以考虑使用「预提交钩子」（pre-commit hook）自动格式化代码。在项目根目录创建.husky/pre-commit文件：

#!/bin/sh npm run lint git add -A

7. 高级功能应用场景

Bitbucket Pipelines可以实现持续集成，在项目根目录添加bitbucket-pipelines.yml：

image: node:14 pipelines: default: - step: script: - npm install - npm test - npm run build

大文件存储可以使用Git LFS，先安装扩展后运行：

git lfs install git lfs track "*.psd" git add .gitattributes

遇到仓库体积过大时，可以用git gc进行垃圾回收。如果克隆速度慢，可以尝试浅克隆：

git clone --depth 1 https://bitbucket.org/team/repo.git

8. 异常情况处理方案

当遇到git push被拒绝时，通常是因为远程有本地不存在的提交。此时不要盲目使用--force，应该先执行：

git pull --rebase

如果不小心提交了敏感信息，可以使用BFG工具清理历史记录：

java -jar bfg.jar --replace-text passwords.txt repo.git

仓库操作日志可以通过git reflog查看，这个命令曾多次帮我找回误删的分支。对于复杂的版本问题，可视化工具gitk能直观展示提交关系图。