Git 与 cnb.cool 完整操作指南

本指南将带你完成从在本地创建项目、上传到 cnb.cool 私有仓库，到在另一台电脑上下载、协作开发的完整流程。

📋 目录

1. 第一部分：本地项目上传到 cnb.cool
2. 第二部分：在新电脑上下载并开发
3. 第三部分：常见问题与解答

---

第一部分：本地项目上传到 cnb.cool

步骤 1：准备本地项目

打开终端（Terminal、Git Bash 等），进入你的项目文件夹，并初始化一个 Git 仓库。

# 进入你的项目目录
cd /path/to/your/project

# 初始化 Git 仓库
git init

步骤 2：创建 cnb.cool 访问令牌

这是向私有仓库推送代码的身份凭证。

1. 登录 cnb.cool，点击右上角头像，进入 个人设置。
2. 在左侧菜单中找到并点击 访问令牌。
3. 点击 添加访问令牌，填写信息：
   • 令牌名：起一个容易识别的名字（如 my-laptop-dev）。
   • 到期时间：根据需要设置。
   • 使用范围：勾选 代码仓库。
   • 授权范围：至少勾选 读写 权限。
4. 点击创建后，立即复制并妥善保存令牌（它只会显示一次）。

💡 关键信息：

• 用户名：固定为 cnb。
• 密码：就是你刚刚申请的访问令牌。

步骤 3：关联远程仓库并推送代码

1. 在 cnb.cool 上创建一个新的私有仓库，并复制其 HTTPS 地址（如 https://cnb.cool/your-username/your-repo.git）。
2. 在本地终端中，添加远程仓库地址：

   git remote add origin https://cnb.cool/your-username/your-repo.git
   

3. 添加文件到暂存区并提交：

   git add .
   git commit -m "feat: 初始化项目"
   

4. 推送代码到远程仓库：

   git push -u origin master
   

   此时终端会提示输入用户名和密码：
   • Username: cnb
   • Password: 粘贴你的访问令牌

成功后，你的代码就完整地托管在 cnb.cool 上了！

---

第二部分：在新电脑上下载并开发

步骤 1：准备新电脑环境

1. 安装 Git：确保新电脑已安装 Git。
2. 配置 Git 用户信息：

   git config --global user.name "你的用户名"
   git config --global user.email "你的邮箱"
   

步骤 2：克隆仓库到本地

1. 获取访问令牌：使用第一部分中创建的令牌，或重新创建一个新的。
2. 获取仓库地址：从 cnb.cool 仓库页面复制 HTTPS 地址。
3. 执行克隆命令：

   git clone https://cnb.cool/your-username/your-repo.git
   

   在提示输入用户名和密码时，分别输入 cnb 和你的访问令牌。

步骤 3：开始开发（最佳实践）

永远不要直接在主分支（master/main）上开发！

1. 进入项目目录并安装依赖：

   cd your-repo
   # 根据项目类型安装依赖，如 npm install, pip install -r requirements.txt
   

2. 创建并切换到新分支：

   git checkout -b feature/your-feature-name
   

3. 进行编码、提交更改：

   git add .
   git commit -m "feat: 添加了新功能XXX"
   

4. 推送分支到远程仓库：

   git push origin feature/your-feature-name
   

5. （可选）在 cnb.cool 上创建合并请求，将你的新分支合并回主分支。

---

第三部分：常见问题与解答

Q1：看到 warning: CRLF will be replaced by LF 这样的警告，怎么办？

A：这不是错误，只是一个关于行尾符的警告。它表示你的文件使用了 Windows 风格的行尾符（CRLF），而 Git 会自动将其转换为 Linux/macOS 风格（LF）。

• 解决方法 1（推荐）：配置 Git 自动处理，一劳永逸。

  git config --global core.autocrlf input
  

• 解决方法 2（最简单）：直接忽略它，不影响代码提交。无需关闭编辑器或重新 git add。

Q2：如何查看和取消 Git 的网络代理设置？

A：如果网络环境变更，可能需要取消之前设置的代理。

• 查看代理：

  git config --global --get http.proxy
  git config --global --get https.proxy
  

• 取消代理：

  git config --global --unset http.proxy
  git config --global --unset https.proxy
  

  执行后，Git 将不再通过代理服务器连接。

Q3：为什么只有仓库地址不能随意上传下载代码？

A：Git 仓库的访问并非仅靠地址，而是有一套权限控制机制。

• 公开仓库：任何人都可以下载（克隆），但只有被仓库所有者授权为协作者的用户才能上传（推送）代码。
• 私有仓库：任何操作（包括下载）都需要身份认证和授权。在 cnb.cool 中，主要通过访问令牌进行认证。没有令牌，即使有地址也无法访问。

Q4：访问令牌是什么？如何安全使用？

A：访问令牌是相当于一个临时、特定权限的密码，用于代表你进行自动化操作或访问受保护资源。

• 安全性：它等同于你的密码，绝对不要提交到代码仓库或分享给他人。
• 管理：建议为不同设备或不同用途创建不同的令牌，并设置合理的有效期。如果怀疑令牌泄露，立即去 cnb.cool 撤销并重新创建。

---

希望这份指南能帮助你高效、安全地使用 Git 和 cnb.cool 进行项目管理！