将本地项目托管到远程仓库（如GitHub、GitLab等），是管理代码和进行协作的基础。核心流程是在远程平台创建仓库，然后在本地初始化Git，最后将两者关联并推送代码。
下面是完整的操作步骤、对应命令及其作用说明：
| 步骤 | 主要操作 | 关键命令/操作 | 作用与说明 |
|---|---|---|---|
| 1. 准备本地环境 | 安装并配置Git | git config --global user.name "Your Name" git config --global user.email "your@email.com" | 设置提交者信息，这是提交代码的必需步骤。 |
| 配置认证方式（以SSH为例） | ssh-keygen -t ed25519 -C "your@email.com" 将公钥( .pub文件)添加到远程平台账户设置中。 | 实现免密安全登录，推荐使用SSH方式。 | |
| 2. 创建远程仓库 | 在GitHub/Gitee等平台创建 | 在网页点击“New Repository”，填写仓库名，建议先不初始化README或.gitignore。 | 获得一个空的线上代码存储地址（HTTPS/SSH URL）。 |
| 3. 初始化本地仓库 | 在项目根目录执行 | git init | 将当前文件夹变为Git管理的本地仓库。 |
| 添加文件到暂存区 | git add . 或 git add <file_name> | 将文件修改添加到暂存区，准备提交。 | |
| 提交到本地仓库 | git commit -m "提交说明" | 创建一次本地版本记录。 | |
| 4. 关联并推送至远程 | 关联远程仓库地址 | git remote add origin <远程仓库SSH地址> | 为远程仓库起一个别名（通常叫origin）。 |
| 推送代码 | git push -u origin main (或 master) | 将本地提交推送到远程仓库的main分支，-u参数用于建立追踪。 |
💡 重要提示与进阶操作
在完成基础推送后，了解以下几点能让你的开发更规范高效：
- 推送更新：后续修改代码后，只需重复执行
git add .、git commit -m "说明"和git push即可。 - 首次推送冲突：如果创建远程仓库时意外初始化了
README文件，直接推送会失败。此时可先执行git pull origin main --allow-unrelated-histories合并历史，再推送。 - 管理不跟踪的文件：在项目根目录创建
.gitignore文件，列出如node_modules/、.env等不需要提交的目录或文件。 - 使用分支：使用
git checkout -b new-feature创建新分支开发功能，完成后合并到主分支，这是一个良好的实践。
