零基础学NPOI：3行代码实现Excel读写

快速体验

1. 打开 InsCode(快马)平台 https://www.inscode.net
2. 输入框内输入如下内容：

创建一个极简NPOI示例项目，包含：1.控制台应用基础模板；2.演示如何用3行代码读取Excel单元格；3.用5行代码创建新工作簿；4.处理常见异常（文件不存在、格式错误等）；5.包含NuGet包安装指引。代码需有详细中文注释，面向完全没接触过NPOI的开发者。

1. 点击'项目生成'按钮，等待项目生成完整后预览效果

最近在做一个数据导出功能时，第一次接触了NPOI这个.NET平台的Excel操作库。作为完全没接触过的新手，我发现它比想象中简单很多，特别适合快速上手。这里记录下我的学习过程，希望能帮到同样想入门NPOI的朋友。

1. 环境准备 首先需要创建一个控制台项目。我用的是Visual Studio 2022，新建项目时选择"控制台应用"模板就行。关键是要通过NuGet安装NPOI包，在解决方案资源管理器里右键项目，选择"管理NuGet程序包"，搜索NPOI安装最新稳定版。这里有个小坑：NPOI有多个衍生包，基础功能只需要安装NPOI和NPOI.OOXML这两个。

2. 读取Excel文件 读取现有Excel文件简单到不可思议。先引用NPOI的命名空间，然后用三行代码就能获取单元格内容：第一行代码用文件流打开Excel，第二行获取工作表对象，第三行指定单元格位置读取值。我测试时发现如果文件路径错误会抛异常，所以最好先用File.Exists判断文件是否存在。

3. 创建新工作簿 生成Excel也很直观。五句核心代码就能搞定：创建空白工作簿→添加工作表→创建行对象→创建单元格→设置单元格值。保存时要注意文件扩展名要与工作簿类型匹配（.xls或.xlsx），否则打开会报错。建议新手先用MemoryStream测试，避免频繁生成实体文件。

4. 常见问题处理 实际使用时遇到过几个典型问题：

5. 文件被占用异常：记得对文件流使用using语句自动释放资源
6. 格式不匹配：读取时要注意单元格数据类型，用ToString()安全转换
7. 空引用异常：操作前检查工作表、行、单元格对象是否为null

8. 性能问题：大数据量操作时建议禁用公式计算

9. 实用建议 对于日常办公自动化需求，NPOI完全够用。相比OpenXML原生API，它的抽象层级更高，代码量能减少70%以上。我后来还发现它支持图表、样式设置等进阶功能，不过新手建议先从基础读写开始练手。调试时可以用Excel的"显示公式"功能对照检查生成结果。

整个过程最让我惊喜的是InsCode(快马)平台的一键部署体验。写完demo代码后直接点击部署按钮，就能生成可运行的在线示例，不用自己配置IIS或服务器。对于想快速验证代码效果的新手特别友好，省去了大量环境搭建时间。

快速体验

1. 打开 InsCode(快马)平台 https://www.inscode.net
2. 输入框内输入如下内容：

创建一个极简NPOI示例项目，包含：1.控制台应用基础模板；2.演示如何用3行代码读取Excel单元格；3.用5行代码创建新工作簿；4.处理常见异常（文件不存在、格式错误等）；5.包含NuGet包安装指引。代码需有详细中文注释，面向完全没接触过NPOI的开发者。

1. 点击'项目生成'按钮，等待项目生成完整后预览效果