:::tip{title="Git代码管理步骤教程"}
Git代码管理十分重要，本文将讲述Git代码管理流程与企业协作规范
:::



## 一、Git 基础概念

1. **什么是 Git**
   - 分布式版本控制系统
   - 核心功能：
     - 记录每次修改（备份）
     - 支持回滚到任意历史版本
     - 团队协作代码整合
2. **仓库（Repository）**
   - 需版本控制的文件目录
   - Git 跟踪并记录目录内所有更新

------

## 二、代码托管平台

1. **主流平台**

   - [**GitHub**](www.github.com)：全球知名，国内访问可能较慢
   - [**Gitee（码云）**](www.gitee.com)：国内最大，访问速度快

   - **注**：企业版支持离线部署（需申请试用）

------

## 三、企业开发流程

1. **分支策略**
   - `master/main`：生产环境稳定分支
   - `develop`：开发环境主分支
   - `feature/xxx`：功能开发分支（基于 develop）
2. **协作流程**
   - 开发者在 `feature/自己名字` 分支工作
   - 完成功能后发起 **Pull Request**
   - 审核通过后合并到 `develop` 分支

------

## 四、Git 核心命令

| 命令                       | 作用             | 示例                                        |
| -------------------------- | ---------------- | ------------------------------------------- |
| `git clone <url>`          | 克隆远程仓库     | `git clone https://gitee.com/user/repo.git` |
| `git checkout -b <分支名>` | 新建并切换分支   | `git checkout -b feature/张三`              |
| `git add <文件>`           | 添加文件到暂存区 | `git add .`（添加所有文件）                 |
| `git commit -m "备注"`     | 提交到本地仓库   | `git commit -m "feat: 新增登录功能"`        |
| `git push`                 | 推送到远程仓库   | `git push origin feature/张三`              |
| `git pull`                 | 拉取远程更新     | `git pull origin develop`                   |
| `git merge <分支>`         | 合并分支         | `git merge feature/张三`                    |
| `git log`                  | 查看提交历史     | `git log --oneline`（简洁模式）             |

------

## 五、实战操作

1. **创建仓库 & 添加成员（Gitee）**

   - 登录 Gitee → 新建仓库 `project-name`
   - 仓库设置 → 成员管理 → 添加成员 `成员名称`

2. **分支管理**

   - 创建 `develop` 分支
   - 基于 `develop` 新建 `feature/自己名字` 分支

3. **克隆仓库到本地**

   ```bash
   git clone https://gitee.com/用户名/project-name.git -b feature/自己名字
   ```

4. **代码提交与推送**

   - 修改文件 → `git add .` → `git commit -m "备注"` → `git push`

5. **合并请求（Pull Request）**

   - 在 Gitee 提交 PR → 审核 → 合并到 `develop`

------

## 六、常见问题

1. **关联远程仓库**
   - 查看关联：`git remote -v`
   - 重命名远程仓库：`git remote rename origin project-name`
2. **冲突解决**
   - 拉取最新代码：`git pull origin develop`
   - 手动解决冲突 → 重新提交

------

## 七、注意与参考

- **备注规范**
  - 新功能：`feat_文件名: 描述`
  - 修复问题：`fixed_文件名: 描述`
- **分支管理原则**
  - 功能开发隔离在 `feature` 分支
  - 定期同步 `develop` 分支避免偏离
- **官方参考文档**
  - Git 官方文档：https://git-scm.com/doc

Git 代码管理步骤教程

:::tip{title="Python面向对象"}
Python第十课，本文将讲述Python面向对象
:::



## 一、面向对象基础

### 1. 类与对象

- **类**：程序中的"设计图纸"，用于描述事物的属性和行为
- **对象**：基于类创建的实体，包含具体数据和行为
- **关系**：类是模板，对象是实例（如：学生类 vs 张三学生对象）

```python
class Student:
    # 属性（成员变量）
    name = None
    age = None
    
    # 行为（成员方法）
    def study(self):
        print(f"{self.name}正在学习")

# 创建对象
stu = Student()
stu.name = "张三"
stu.study()
```

### 2. 成员方法

- **定义**：类中定义的函数称为方法
- **self**：必须作为第一个参数，表示对象自身
- **调用**：通过对象调用时自动传递self参数

```python
def introduce(self):
    print(f"我叫{self.name}，今年{self.age}岁")
```

### 3. 构造方法

- **作用**：对象创建时自动执行初始化
- **语法**：`__init__`
- **特性**：可接收参数初始化成员变量

```python
def __init__(self, name, age):
    self.name = name
    self.age = age
```

---

## 二、面向对象三大特性

### 1. 封装

- **核心**：隐藏实现细节，暴露安全接口
- **私有成员**：`__`开头的变量/方法（实际是名称改写）
- **访问控制**：
  - 公有成员：可被外部访问
  - 私有成员：仅类内部访问

```python
class Phone:
    __voltage = 3.7  # 私有变量
    
    def __check_5g(self):  # 私有方法
        if self.__voltage > 3:
            return True
            
    def call(self):  # 公有方法
        if self.__check_5g():
            print("5G通话已开启")
```

### 2. 继承

- **单继承**：`class 子类(父类)`
- **多继承**：`class 子类(父类1, 父类2)`
- **方法重写**：子类定义同名方法覆盖父类实现
- **super()**：调用父类方法

```python
class AndroidPhone(Phone):
    def __init__(self, brand):
        super().__init__()  # 调用父类构造
        self.brand = brand
        
    def call(self):  # 方法重写
        print(f"{self.brand}定制化通话界面")
        super().call()
```

### 3. 多态

- **核心**：相同接口不同实现
- **实现方式**：
  - 继承：子类重写父类方法
  - 抽象类：定义方法规范

```python
from abc import ABC, abstractmethod

class Animal(ABC):
    @abstractmethod
    def sound(self):
        pass

class Dog(Animal):
    def sound(self):
        return "汪汪"

class Cat(Animal):
    def sound(self):
        return "喵喵"
```

---

## 三、高级特性

### 1. 魔术方法

- `__str__`：定义对象字符串表示
- `__eq__`：定义相等比较逻辑
- `__lt__`：定义大小比较逻辑

```python
class Product:
    def __init__(self, price):
        self.price = price
        
    def __str__(self):
        return f"产品价格：{self.price}"
        
    def __lt__(self, other):
        return self.price < other.price
```

### 2. 类型注解

- **变量注解**：`var: type`
- **函数注解**：参数和返回值类型提示
- **Union类型**：联合类型注解

```python
from typing import Union

def process(data: Union[int, str]) -> list:
    return [data] * 3
```

---

## 四、综合应用模式

### 数据处理案例设计

1. **数据封装**：创建数据类统一存储格式
2. **读取器类**：抽象基类定义接口
3. **多态处理**：不同文件格式子类实现
4. **计算分析**：独立业务类处理数据
5. **可视化**：使用PyEcharts进行展示

```python
# 数据基类
class BaseData:
    def __init__(self, date, amount):
        self.date = date
        self.amount = amount

# 文件读取器（抽象类）
class FileReader:
    def read(self, path) -> list[BaseData]:
        raise NotImplementedError

# CSV实现
class CSVReader(FileReader):
    def read(self, path):
        # 解析CSV返回BaseData列表
        pass

# 业务处理
class DataAnalyzer:
    def __init__(self, reader: FileReader):
        self.reader = reader
        
    def daily_summary(self, path):
        data = self.reader.read(path)
        # 计算逻辑...
```

---

## 五、关键总结

1. **类设计三要素**：属性、方法、构造
2. **封装核心**：私有成员保护数据安全
3. **继承要点**：代码复用与扩展
4. **多态本质**：接口统一，实现不同
5. **类型注解**：提升代码可读性
6. **设计模式**：高内聚低耦合，面向接口编程

Python面向对象

:::tip{title="闲置笔记本变身黑群晖NAS教程"}
俗话说：“**中年有三宝：路由（软）、充电插座、Nas**”

从本系列开始将讲述：闲置笔记本改造黑群晖NAS，低成本实现文件共享、远程访问及多媒体服务，教程详解硬件适配与系统安装，助老旧设备焕发新生。
:::



## 一、NAS是什么：
**NAS（网络附加存储）** 是一种通过局域网（LAN）或互联网提供集中化数据存储与共享的设备或系统，由硬件（如硬盘、服务器）和软件（如操作系统、管理界面）构成。用户可通过电脑、手机、平板等终端随时访问存储在NAS中的文件（如文档、照片、视频），并支持多设备协同操作。其核心优势包括：  
1. **数据集中管理**：避免多设备存储分散，便于备份与同步；  
2. **远程访问**：通过公网IP或DDNS域名，随时随地访问家中文件；  
3. **多媒体服务**：可直接搭建影音服务器（如Plex/Jellyfin），流式播放高清内容；  
4. **扩展性**：支持硬盘扩容（如RAID配置）或软件定义存储（如TrueNAS Scale）；  
5. **安全性**：提供用户权限控制、加密传输等功能，保障隐私。  
NAS既可是专用硬件设备（如群晖DS系列），也可通过普通电脑安装系统（如TrueNAS Core、黑群晖）实现，成本灵活，是家庭与企业数据管理的理想解决方案。

## 二、NAS配置目标：
注：由于预算有限，配置参数可能有点可怜。使用NAS目的只为学习使用。如果有了一定费用再讨论硬件配置选型

:::info{title="基本信息"}
硬件配置：

1. 硬件型号：华硕笔记本电脑u4000
2. 处理器：英特尔7代i5
3. 内存：12G
4. 硬盘：256G
    
NAS刷黑群晖目标：

1. 黑群晖产品型号：DS920+
2. DSM版本：DSM7.1.1
    
:::

## 三、准备工作
1. U盘1个≥4G （注：U盘要一直插在群晖设备上）推荐用U盘引导,灵活方便；
2. 工作电脑1台；要求电脑和群晖在同一个局域网，建议网线有线连接，因为WiFi不稳定。
3. 刷黑群晖主机  (近15年内的电脑一般都可以，内存≥4GB 推荐intel+核显）路由器开启DHCP、设备插好网线、鼠标、键盘、显示器、硬盘。
4. 准备资料：
[闲置笔记本变身黑群晖NAS教程准备资料.zip](https://dageling003-vanblog-picgo-1323173970.cos.ap-shanghai.myqcloud.com/img/%E9%97%B2%E7%BD%AE%E7%AC%94%E8%AE%B0%E6%9C%AC%E5%8F%98%E8%BA%AB%E9%BB%91%E7%BE%A4%E6%99%96NAS%E6%95%99%E7%A8%8B%E5%87%86%E5%A4%87%E8%B5%84%E6%96%99.zip)
或者[百度网盘链接](https://pan.baidu.com/s/1eb84taoSCX4iv8p5ufSxMw?pwd=oze9)

5. 一台windows的控制Nas的电脑

## 四、刷黑群晖步骤
解压准备资料压缩包，压缩包里有以下内容
:::note{title="准备资料压缩包内容"}
-  arpl.img                        - 黑群晖启动U盘镜像
-  DSM_DS920+_42962.pat            - DS920+的黑群晖包
-  nasxunlei-DSM7-x86_64.spk       - 群晖迅雷软件包        
-  rufus-4.4p.exe                  - 制作启动u盘安装包
:::
### 1、U盘引导安装
1. 安装`制作启动u盘安装包rufus-4.4p.exe`在`控制Nas的电脑`上
2. 打开`rufus`,插入启动U盘在`控制Nas的Windows电脑`上
3. 选择你所准备插入的`启动U盘驱动器`，选择镜像文件`arpl.img`黑群晖启动U盘镜像刷入你的启动u盘
4. 注意：确认刷入后启动U盘将格式化重新导入内容在你所插入的U盘里，所以可以用没有作用的小U盘
5. 完成后拔出启动U盘，然后插入刷黑群晖主机，注意插入就不可拔出了，不然无法接下来的步骤

### 2、黑群晖主机刷入
1. 插入U盘：刷Nas电脑里有系统，则需要bios启动进入U盘
![bios启动键](https://dageling003-vanblog-picgo-1323173970.cos.ap-shanghai.myqcloud.com/img/bios%E5%90%AF%E5%8A%A8%E7%83%AD%E9%94%AE.jpg)
2. 选择从U盘引导
3. 出现有图中这样的信息在windows的控制电脑输入所指定的IP地址和端口号
![NAS1-1](https://dageling003-vanblog-picgo-1323173970.cos.ap-shanghai.myqcloud.com/img/NAS1-1.png)
`192.168.xx.xx:7681(ip每个人不一样)`
4. 配置黑群辉
![NAS1-2](https://dageling003-vanblog-picgo-1323173970.cos.ap-shanghai.myqcloud.com/img/nas1-2.png)
回车
![NAS1-3](https://dageling003-vanblog-picgo-1323173970.cos.ap-shanghai.myqcloud.com/img/nas1-3.png)
下移动，选择DS920+
![NAS1-4](https://dageling003-vanblog-picgo-1323173970.cos.ap-shanghai.myqcloud.com/img/NAS1-4.png)
默认啥不要动，选择版本号，回车
![NAS1-5](https://dageling003-vanblog-picgo-1323173970.cos.ap-shanghai.myqcloud.com/img/nas1-5.png)
回车一下后不要动自动会来到第三个
![NAS1-6](https://dageling003-vanblog-picgo-1323173970.cos.ap-shanghai.myqcloud.com/img/nas1-6.png)
选第一个生成一个串号
![NAS1-7](https://dageling003-vanblog-picgo-1323173970.cos.ap-shanghai.myqcloud.com/img/nas1-7.png)
确认安装去跑码
![NAS1-8](https://dageling003-vanblog-picgo-1323173970.cos.ap-shanghai.myqcloud.com/img/nas1-8.png)
等待一会儿
![NAS1-9](https://dageling003-vanblog-picgo-1323173970.cos.ap-shanghai.myqcloud.com/img/nas1-9.png)
跑完2个进度条且如果ok显示会跳回刚刚的蓝色背景页面
![NAS1-10](https://dageling003-vanblog-picgo-1323173970.cos.ap-shanghai.myqcloud.com/img/nas1-8.png)
重启电源`目标刷黑群晖主机`或在`目标刷黑群晖主机`机器上输入：

```
reboot
```
 重启`目标刷黑群晖主机`后会有这个页面：
![NAS1-11](https://dageling003-vanblog-picgo-1323173970.cos.ap-shanghai.myqcloud.com/img/nas1-10.png)

192.168.XX.XX

**注：没有7681端口！！图中的地址是别人的，请根据实际的操作！**

打开浏览器，输入ip地址,选择安装
![NAS1-12](https://dageling003-vanblog-picgo-1323173970.cos.ap-shanghai.myqcloud.com/img/nas1-11.png)
浏览上传DS920+的黑群晖包的安装包`DSM_DS920+_42962.pat`，下一步
![NAS1-13](https://dageling003-vanblog-picgo-1323173970.cos.ap-shanghai.myqcloud.com/img/nas1-12.png)
勾选继续，加载安装，运行然后会等待10分钟。注意不要断电和网络
![NAS1-14](https://dageling003-vanblog-picgo-1323173970.cos.ap-shanghai.myqcloud.com/img/nas1-13.png)
加载安装完成后重新打开浏览器的`192.168.xx.xx`,高级继续访问
![NAS1-15](https://dageling003-vanblog-picgo-1323173970.cos.ap-shanghai.myqcloud.com/img/nas1-14.png)
设置设备名，管理员账户，密码：
![NAS1-16](https://dageling003-vanblog-picgo-1323173970.cos.ap-shanghai.myqcloud.com/img/nas1-15.png)
![NAS1-17](https://dageling003-vanblog-picgo-1323173970.cos.ap-shanghai.myqcloud.com/img/NAS1-16.png)
2个跳过，提交
**至此，你的黑群晖Nas刷成功了**

### 3.基本配置NAS
![NAS1-18](https://dageling003-vanblog-picgo-1323173970.cos.ap-shanghai.myqcloud.com/img/nas1-17.png)
立即创建->开始->SHR->下一步->勾选硬盘->下一步->跳过->几个默认都选下一步->应用
![NAS1-19](https://dageling003-vanblog-picgo-1323173970.cos.ap-shanghai.myqcloud.com/img/nas1-18.png)
至此，根据一步步上文一步步操作就刷好了黑群晖

## 最后
革命尚未成功，黑群晖还有很多值得去探索。那么就下篇见
如果你有问题，欢迎你私信联系我

闲置笔记本变身黑群晖NAS教程

:::tip{title="Vanblog安装步骤"}
VanBlog 是一款简洁实用优雅的高性能个人博客系统。本文将参考VanBlog官方文档和实际情况进行部署。操作步骤结果均已成功，特此记录一下安装步骤。
:::



## 1.基本信息：

需提前打开服务器端口：**80，443**

博客部署服务器操作系统环境：**openclouds8(基于centos8)**

安装博客系统目标：[vanblog(官方文档网站:https://vanblog.mereith.com/)](https://vanblog.mereith.com/)

需要提前安装的服务：**docker；mongodb（docker版本）**

## 2.操作步骤

### 1.初准备

更新系统：

```
 yum update -y
```

### 2.安装docker服务：因为vanblog基于docker打包部署

安装 Docker 依赖

```
yum install -y yum-utils
```

添加 Docker 官方仓库

```
yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
```

安装 Docker

```
yum install -y docker-ce docker-ce-cli containerd.io
```

启动并启用 Docker

```
systemctl start docker
systemctl enable docker
systemctl status docker
```

验证 Docker 安装

```
docker --version  
```

输出类似 Docker version 20.10.xx

### 3.docker版mongodb安装：因为vanblog的数据库服务基于docker版mongodb

在配置vanblog时，vanblog官网使用docker和脚本部署时会报错。然后在vanblog发现了一句话

```
 # 某些机器不支持 avx 会报错，所以默认用 v4 版本。有的话用最新的。
  image: mongo:4.4.16
```

:::danger{title="mongodb v4.4 生命周期结束"}
V4.4 已于 2024 年 2 月 29 日到期，MongoDB 不再提供支持。

具体情况详见官网：

https://www.mongodb.com/zh-cn/docs/manual/administration/production-notes/#std-label-prod-notes-supported-platforms-x86_64

:::
****


编辑 Docker 配置文件

```
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://mirror.ccs.tencentyun.com",  
    "https://hub-mirror.c.163.com"       
  ]
}
EOF
```

重启 Docker 服务

```
sudo systemctl daemon-reload
sudo systemctl restart docker
```

验证配置生效

```
Registry Mirrors:
 https://mirror.ccs.tencentyun.com/
 https://hub-mirror.c.163.com/
```

腾讯云镜像仓库镜像站地址拉取：

```
docker pull mirror.ccs.tencentyun.com/library/mongo:6.0
```

网易云镜像仓库镜像站地址拉取：

```
docker pull hub-mirror.c.163.com/library/mongo:6.0
```

### 4.安装vanblog,使用脚本部署安装

脚本部署vanblog

```
curl -L https://vanblog.mereith.com/vanblog.sh -o vanblog.sh && chmod +x vanblog.sh && ./vanblog.sh
```

如果未来需要再次运行脚本，可直接运行：

```
./vanblog.sh
```

打开浏览器，直接访问浏览器就可以配置博客啦

```
https://<你的域名>/admin/init
```

Vanblog安装步骤

:::tip{title="Python异常、模块与包"}
Python第九课：Python异常、模块与包
:::



## 一、异常处理

1. **异常概念**
   - 异常是程序运行时遇到的错误， Python通过异常机制处理这些错误。
   - 异常使得程序能够优雅地处理错误，而不是直接崩溃。

2. **捕获异常**
   - 使用`try`和`except`语句捕获异常。
   ```python
   try:
       # 可能出错的代码
       f = open('linux.txt', 'r')
   except:
       # 异常处理
       f = open('linux.txt', 'w')
   ```

3. **捕获指定异常**
   - 可以捕获特定类型的异常，如`ZeroDivisionError`。
   ```python
   try:
       print(1/0)
   except ZeroDivisionError:
       print("除以零错误")
   ```

4. **捕获多个异常**
   - 使用元组捕获多种异常。
   ```python
   try:
       print(1/0)
   except (ZeroDivisionError, NameError):
       print("发生错误")
   ```

5. **异常处理块**
   - `else`：无异常时执行。
   - `finally`：无论是否出现异常都执行，常用于资源释放。
   ```python
   try:
       # 可能出错的代码
       f = open('test.txt', 'r')
   except Exception as e:
       print(f"出现异常：{e}")
   else:
       print("没有异常")
   finally:
       f.close()
   ```

6. **异常传递**
   - 异常会从函数内部传递到外部，直到被捕获为止。

## 二、模块

1. **模块概念**
   - 模块是Python文件（.py），包含函数、类和变量。

2. **导入模块**
   - `import 模块名`
   - `from 模块名 import 函数/类/变量`
   - `import 模块名 as 别名`

3. **自定义模块**
   - 创建Python文件即可作为模块。
   - 使用`__main__`控制测试代码是否在导入时执行。
   ```python
   def test():
       print("测试")
   
   if __name__ == '__main__':
       test()
   ```

4. **模块注意事项**
   - `__all__`变量控制`import *`时的导入内容。

## 三、包

1. **包概念**
   - 包是文件夹，包含`__init__.py`文件，用于管理和组织模块。

2. **创建包**
   - 新建文件夹，添加模块和`__init__.py`。

3. **导入包**
   - `import 包名.模块名`
   - `from 包名 import 模块名`

4. **包结构示例**
   ```plaintext
   my_utils/
       __init__.py
       str_util.py
       file_util.py
   ```

5. **使用包**
   ```python
   import my_utils.str_util
   my_utils.str_util.str_reverse("hello")
   ```

## 四、第三方包

1. **安装第三方包**
   - 使用pip安装
   ``` python
   pip install 包名
   ```
   - 使用国内镜像（如清华大学的镜像）来加速安装
   ``` python
   pip install -i https://pypi.tuna.tsinghua.edu.cn/simple 包名
   ```
   - 如想切换或使用其他的，详见下一篇文章
3. **PyCharm安装**
   - 通过PyCharm的项目解释器界面安装。
   - 在PyCharm中，点击`File` -> `Settings` -> `Project: 项目名` -> `Python Interpreter` -> `+` -> `Install Package`。

     ![py009-1](https://dageling003-vanblog-picgo-1323173970.cos.ap-shanghai.myqcloud.com/img/py009-01.png)
     
     ![py009-2](https://dageling003-vanblog-picgo-1323173970.cos.ap-shanghai.myqcloud.com/img/py009-02.png)
     
     ![py009-3](https://dageling003-vanblog-picgo-1323173970.cos.ap-shanghai.myqcloud.com/img/py009-03.png)

## 五、综合案例

1. **自定义包示例**
   - 创建包`my_utils`，包含`str_util.py`和`file_util.py`模块。

2. **使用自定义包**
   ```python
   import my_utils.str_util as su
   import my_utils.file_util as fu
   
   # 使用字符串工具
   print(su.str_reverse("hello"))  # 输出：olleh
   
   # 使用文件工具
   fu.append_to_file("test.txt", "添加内容")
   ```

---

## 总结

- **异常处理**：增强程序的健壮性，确保程序在出现错误时能够优雅处理。
- **模块**：帮助组织代码，提高代码的复用性。
- **包**：用于管理多个模块，使代码结构更清晰。
- **第三方包**：扩展Python功能，提高开发效率。