一、前置准备

1. 注册并登录 GitCode 账号：https://gitcode.com/
2. 在 GitCode 网页端创建空仓库，记录仓库地址（格式示例：https://gitcode.com/你的用户名/仓库名.git）

二、仓颉 IDE 内操作全流程

步骤 1：创建仓颉项目

1. 打开「CodeArts IDE for Cangjie」
2. 点击「新建项目」→ 选择「仓颉工程」
3. 填写项目名称（如 demo1_1）、选择本地保存路径 → 点击「创建」
4. 等待项目初始化完成，自动生成 src/main.cj、cjpm.toml 等核心文件

   步骤 2：打开终端并进入项目目录

5. 点击 IDE 底部「终端」按钮，打开命令行窗口
6. 执行命令进入项目根目录（替换为你的实际路径）：

   cd D:\soft\cangjie\xiangmu\demo1_1

   步骤 3：初始化 Git 仓库

   执行命令初始化 Git 版本管理：

   git init

   说明：生成隐藏 .git 文件夹，标记当前文件夹为 Git 仓库

   步骤 4：添加文件到暂存区

   执行命令将所有项目文件加入暂存区：

   git add .

   说明：

   • . 代表添加当前目录下所有文件，也可指定单个文件（如 git add src/main.cj）
   • 若提示 LF will be replaced by CRLF，为 Windows 换行符格式警告，不影响操作，可忽略

   步骤 5：提交到本地仓库

   执行命令提交代码到本地 Git 仓库：

   git commit -m "初始化仓颉项目 demo1_1"

   说明：-m 后必须填写提交备注，用于描述本次修改内容（如 “新增登录功能”“修复启动 bug”）

   步骤 6：绑定 GitCode 远程仓库

   执行命令绑定 GitCode 仓库（替换为你的 GitCode 仓库地址）：

   git remote add origin https://gitcode.com/你的用户名/demo1_1.git

   验证绑定是否成功：

   git remote -v

   输出中包含 GitCode 仓库地址（fetch/push 两条记录）即绑定成功

   步骤 7：推送代码到 GitCode

   根据本地分支名称选择对应命令：

   情况 1：使用默认 master 分支（仓颉 IDE 默认）

   git push -u origin master

   情况 2：使用 main 分支（主流推荐）

   先重命名本地分支，再推送：

   # 重命名本地 master 分支为 main
   git branch -m master main
   # 推送 main 分支到 GitCode
   git push -u origin main

   常见问题处理：1.报错 non-fast-forward：远程仓库已有内容，先合并历史再推送

   git pull origin master --allow-unrelated-histories
   git push -u origin master

                          2.确认本地代码为最新版本，需强制覆盖远程：

   git push -f origin master

   ⚠️ 警告：强制推送会覆盖远程所有代码，仅在个人项目且确认无重要数据时使用

   步骤 8：验证推送结果

7. 先打开浏览器访问 GitCode 仓库地址（如 https://gitcode.com/你的用户名/demo1_1）
8. 登录账号后，可查看项目文件（main.cj、cjpm.toml）和提交记录，即完成代码同步

三、日常开发更新代码流程

# 1. 拉取 GitCode 最新代码（避免冲突）
git pull origin master

# 2. 在仓颉 IDE 中修改/新增代码

# 3. 添加修改文件到暂存区
git add .

# 4. 提交到本地仓库
git commit -m "修改说明：如新增XX功能"

# 5. 推送到 GitCode（首次推送后无需加 -u origin master）
git push

四、关键命令速查表

五、注意事项

1. 分支命名：仓颉 IDE 默认分支为 master，可根据习惯重命名为 main，推送时分支名需与本地一致
2. 提交规范：每次提交都需填写清晰备注，方便后续追溯代码变更
3. 安全提醒：避免在公共设备保存 Git 账号密码，优先使用 OAuth 或 SSH 方式认证