Git新手VS Code配置主测试分支、自动提交及保密文件处理

1. 创建仓库并配置main分支（手动提交推送） #

本地初始化与分支设置 #

• 打开VS Code，导入你的项目文件夹
• 点击左侧源码控制面板（分支三角形图标），点击「初始化仓库」
• 若默认分支为master，执行Git命令重命名为main：

  git branch -m main
  

  也可在VS Code分支下拉菜单中直接重命名分支

手动提交与推送 #

• 在源码控制面板中，将需要提交的文件拖到「暂存区」（或点击顶部「+」按钮）
• 在提交信息输入框填写清晰描述（如「初始化项目结构」），点击对勾完成本地提交
• 关联远程仓库：点击面板顶部「发布分支」，输入远程仓库URL（如GitHub空仓库地址）完成推送
• 后续main分支的所有修改，均遵循暂存→提交→手动点击推送按钮的流程，确保仅测试通过的代码进入main

2. 配置test分支（自动提交推送+PR审核） #

创建test分支 #

• 在VS Code分支下拉菜单中，选择「创建新分支」，命名为test，基于main分支创建

配置自动提交推送 #

方式1：VS Code插件（新手友好）

• 安装「Auto Commit」插件，打开插件设置：
  • 开启「Auto Commit」和「Auto Push」选项
  • 在「Allowed Branches」中添加test，限制仅在test分支生效
  • 设置「Commit Interval」（如30秒），插件会自动暂存修改、提交并推送到远程test分支

方式2：Git钩子（无需插件）

• 找到本地仓库的.git/hooks目录（需在Windows中开启显示隐藏文件）
• 创建post-commit文件（无后缀），写入以下内容：

  #!/bin/sh
  git push origin test
  

• 右键该文件→属性→勾选可执行权限，之后每次在test分支提交后，Git会自动推送到远程

PR审核与合并 #

• 当test分支功能完成初步测试后，打开VS Code的「GitHub Pull Requests and Issues」插件（需提前安装并登录）
• 点击「Create Pull Request」，选择base: main、compare: test，填写PR描述后提交
• 在插件中查看PR的代码变更、评论，确认无误后点击「Merge Pull Request」
• 回到本地main分支，执行git pull origin main拉取合并后的最新代码，main分支仍保持手动提交推送的操作逻辑

3. 分支专属.gitignore（main隐藏保密文件，test可见） #

创建分支专属忽略文件 #

• 在项目根目录创建两个文件：.gitignore-main和.gitignore-test
  • .gitignore-main：添加需要隐藏的保密内容，例如：

    secrets/
    .env
    config/secure.json
    

  • .gitignore-test：无需添加上述保密文件规则（可根据test分支需求配置其他忽略项）

配置分支专属忽略规则 #

• 切换到main分支，执行以下命令：

  git config branch.main.core.excludesFile .gitignore-main
  

• 切换到test分支，执行以下命令：

  git config branch.test.core.excludesFile .gitignore-test
  

生效注意事项 #

• 若之前已将保密文件提交到分支，需先从对应分支移除追踪：

  # 在main分支执行
  git rm --cached secrets/ .env
  git commit -m "停止追踪保密文件"
  

• 切换分支后，VS Code会自动识别当前分支的忽略规则，无需手动修改.gitignore

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