# 实验一：工欲善其事——开发环境搭建与版本控制入门

文档版本历史

| 版本 | 日期       | 修改人   | 修改内容                 |
| :--- | :--------- | :------- | :----------------------- |
| V1.0 | 2024-xx-xx | 邓秀蕊 | 初始版本创建             |
| V1.1 | 2024-xx-xx | 邓秀蕊 | 增加视频转播比分显示模块 |
| V1.2 | 2024-xx-xx | 邓秀蕊 | 增加赛程安排功能模块     |

## 实验信息
- **实验学时**：2学时
- **实验地点**：宿舍
- **合作者**：无（如有结对）

##  实验目的
- [ ] 掌握VSCode的安装及必要插件配置
- [ ] 掌握Git的基本操作（init, clone, add, commit, push, pull）
- [ ] 熟悉Markdown语法，能够编写结构化的文档

## 实验环境
- **操作系统**：Windows 11 / macOS / Linux
- **开发工具**：Visual Studio Code
- **版本控制**：Git (v2.53.0)
- **远程仓库**：GitHub / Gitee
- **VSCode插件列表**：
  - Markdown All in One
  - Draw.io Integration
  - GitLens
  - 其他：Code Spell Checker

## 实验内容与步骤

### VSCode环境配置
1. 安装VSCode并配置插件（截图展示插件列表）：
  ![VSCode插件列表](https://i.postimg.cc/dQksbLbF/an-zhuang-VSCode-bing-pei-zhi-cha-jian.png)

2. 配置VSCode设置（如字体大小、自动保存等）：
  ![VSCode设置页面1](https://i.postimg.cc/CMq0v98p/pei-zhi-VSCode-she-zhi-1.png)
  ![VSCode设置页面2](https://i.postimg.cc/3JjThpn5/pei-zhi-VSCode-she-zhi-2.png)



// 主要配置项说明

1. 设置"editor.fontSize": 14
2. 开启"files.autoSave": "afterDelay"

###   Git仓库创建与克隆
1. 远程仓库创建（截图展示远程仓库页面）：
   
 ![远程仓库创建页面](https://i.postimg.cc/1zkC473w/yuan-cheng-cang-ku-chuang-jian.png)

仓库地址：https://bdgit.educoder.net/px69why5e/Demo.git

1. 本地克隆与配置：

克隆仓库（ 命令及截图展示）

 ![Git克隆仓库命令](https://i.postimg.cc/MZbPKD29/ke-long-cang-ku.png)

配置用户信息（ 命令及截图展示）
 ![Git配置用户信息](https://i.postimg.cc/FH2gxdX1/pei-zhi-yong-hu-xin-xi.png)
### Git提交操作

1. 查看状态与添加文件：

   bash

   ```
   git status
   git add .
   git commit -m "Initial commit: 添加实验一报告模板"
   ```

   

2. 提交记录截图：

  ![查看状态与添加文件](https://i.postimg.cc/WzHJbC2P/cha-kan-zhuang-tai-yu-tian-jia-wen-jian.png)

3. 推送到远程仓库：

   bash

   ```
   git push origin main
   ```

   

## 实验结果与分析

### Git提交日志

bash

```
$ git log --oneline
 粘贴命令执行结果
```



### 远程仓库验证

- 登录远程仓库，确认文件已成功推送

- 截图验证：

  ![确认仓库文件推送](https://i.postimg.cc/7hsSJbNJ/deng-lu-yuan-cheng-cang-ku-que-ren-wen-jian-yi-cheng-gong-tui-song.png)

## 遇到的问题及解决方法

| 问题描述                       | 解决方法                                               |
| :----------------------------- | :----------------------------------------------------- |
| git push时提示权限denied       | 配置SSH密钥，使用`ssh-keygen`生成并添加到远程仓库      |
| VSCode中Markdown预览不显示图片 | 检查图片路径，使用相对路径如`images/实验名/图片名.png` |

## 实验总结

- 本次实验掌握了VSCode+Git+Markdown的基本使用
- 学会了掌握VSCode+Git+Markdown基础操作，完成环境搭建与版本控制流程。
- 不足之处Git进阶操作不熟，Markdown复杂排版与工具协同能力待提升。

## 实验参考资料