Demo/report1.md

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

文档版本历史

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

实验信息

• 实验学时：2学时
• 实验地点：4403
• 合作者：无

实验目的

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

实验环境

• 操作系统： macOS
• 开发工具：Visual Studio Code
• 版本控制：Git (v____)
• 远程仓库：GitHub
• VSCode插件列表：
  • Markdown All in One
  • Draw.io Integration
  • GitLens

实验内容与步骤

VSCode环境配置

1. 安装VSCode并配置插件（截图展示插件列表）：

2. 配置VSCode设置（如字体大小、自动保存等）：

// 主要配置项说明

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

Git仓库创建与克隆

1. 远程仓库创建（截图展示远程仓库页面）：

仓库地址：https://github.com/shimai0603/se2026-lab-shimai.git

2. 本地克隆与配置：

克隆仓库（ 命令及截图展示） 配置用户信息（ 命令及截图展示）

Git提交操作

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

   bash

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

2. 提交记录截图：

3. 推送到远程仓库：

   bash

   git push origin main
   

实验结果与分析

Git提交日志

bash

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

远程仓库验证

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

• 截图验证：

遇到的问题及解决方法

问题描述	解决方法
git push时提示权限denied	在 GitHub 「Settings → Developer settings → Personal access tokens」中生成新的 PAT，勾选 repo 权限；推送时使用 PAT 作为密码进行 HTTPS 认证
VSCode中Markdown预览不显示图片	检查图片路径，使用相对路径如images/实验名/图片名.png

实验总结

• 本次实验掌握了VSCode+Git+Markdown的基本使用
• 学会了VSCode 环境配置、Markdown 图片插入、Git 版本控制，以及用 PAT 解决 GitHub 推送权限问题
• 不足之处：对 PAT 授权和图片路径配置的熟练度不足，需要多加练习

实验参考资料