jupyter notebook代码如何放置附录

### 组织和放置附录代码的最佳实践

#### 使用独立单元格分隔功能模块

为了保持Jupyter Notebook的整洁性和可读性，建议将不同部分的功能逻辑放在不同的单元格内。对于附录代码而言，可以创建专门的部分来容纳这些额外的内容[^1]。

# 主要分析函数定义
def analyze_data(data):
    """执行数据分析的主要流程"""
    pass  # 假设这里有一些复杂的处理操作

---

# %% Appendix A: 辅助计算函数
def helper_function(x, y):
    """这是一个仅作为补充说明用途的帮助函数"""
    return x + y

通过这种方式，读者能够轻松地区分核心业务逻辑和支持性的附加材料。

#### 利用Markdown标记章节结构

借助于Markdown语法中的标题标签（`###`, `####`），可以在Notebook里构建清晰的文章框架，使得各个板块之间的关系更加直观明了。

#### 创建单独文件存储大型脚本

当某些辅助程序变得非常庞大时，考虑将其保存成`.py`形式的小型外部库，并在当前工作空间中导入它们。这不仅有助于减少单个notebook文件体积过大带来的不便，也方便后续维护与重用[^2]。

!pip install .
# 或者使用相对路径指定本地包的位置
import sys
sys.path.append('path/to/your/package')
from mypackage import some_module

#### 应用魔法命令优化交互体验

利用IPython特有的魔术指令如 `%load_ext` 加载特定扩展插件；或是采用 `%%writefile` 将多行输入直接写入磁盘上的新文件中，从而简化重复任务并增强灵活性。

%load_ext autoreload
%autoreload 2

---

%%writefile utils.py
def utility_func():
    print("This is a utility function.")