代码注释与文档

**示例代码：**
```python
import os
import hashlib

def calculate_file_hash(filepath, algorithm='sha256'):
if not os.path.exists(filepath):
raise FileNotFoundError(f"路径不存在: {filepath}")
block_size = 65536
hash_obj = hashlib.new(algorithm)
with open(filepath, 'rb') as f:
for chunk in iter(lambda: f.read(block_size), b''):
hash_obj.update(chunk)
return hash_obj.hexdigest()
```

**成品输出：**

```python
import os
import hashlib

def calculate_file_hash(filepath, algorithm='sha256'):
"""
计算指定文件内容的哈希值。

参数:
filepath (str): 目标文件的路径。
algorithm (str, optional): 使用的哈希算法名称，默认为 'sha256'。支持 hashlib 中所有可用的算法（如 'md5', 'sha1', 'sha512' 等）。

返回:
str: 文件内容的十六进制哈希字符串。

异常:
FileNotFoundError: 如果指定的文件路径不存在，则抛出此异常。
ValueError: 如果传入的 algorithm 参数不是 hashlib 支持的算法名称，则抛出此异常。
"""
# 检查文件是否存在，若不存在则直接抛出 FileNotFoundError
if not os.path.exists(filepath):
raise FileNotFoundError(f"路径不存在: {filepath}")
# 设置读取块大小，使用 64KB 作为默认缓冲区大小以平衡内存与 I/O 效率
block_size = 65536
# 根据传入的算法名称初始化哈希对象
hash_obj = hashlib.new(algorithm)
# 以二进制模式打开文件，使用迭代器分块读取
with open(filepath, 'rb') as f:
# 每次读取 block_size 大小的数据块，直到文件结束
for chunk in iter(lambda: f.read(block_size), b''):
# 将读取的数据块更新到哈希对象中
hash_obj.update(chunk)
# 返回最终计算得到的十六进制哈希值
return hash_obj.hexdigest()

# 使用示例：
# 1. 计算文件 default_example.txt 的 SHA-256 哈希值
# print(calculate_file_hash("default_example.txt"))
# 2. 计算文件 backup.zip 的 MD5 哈希值
# print(calculate_file_hash("backup.zip", algorithm="md5"))
# 3. 尝试访问不存在的文件以触发异常处理
# try:
# calculate_file_hash("non_exist_file.log")
# except FileNotFoundError as e:
# print(e)
```

示例依据本页提示词生成，实际效果以你所用模型与参数为准