常见问题解答

关于 NodePy 图形化 Python 编辑器的所有问题，这里都有答案

📌 基础概念

什么是 NodePy？ +

NodePy（简易中文节点 Python 编辑器）是一款面向非程序员的图形化编程工具。用户通过拖拽节点和连接线即可构建可执行的数据流图，无需编写传统代码即可完成 Python 编程任务。

核心特点：

  • 拖拽式节点操作，支持多种添加方式（拖拽/双击/右键菜单/空格搜索）
  • 内置 6 大类节点库（输出、常量、数据处理、循环、文本、Debug）
  • 支持自定义 Python 节点和 AI 代码生成
  • 多线程并发处理，高性能执行引擎
  • 完全免费，开源项目（MIT License）
NodePy 适合哪些人使用？ +

NodePy 主要适合以下人群：

  • 零基础初学者：想学编程但被代码语法劝退的人
  • 办公人员：需要处理 Excel、文件批量操作等自动化任务
  • 数据分析师：需要可视化数据清洗和转换流程
  • 教师：用于编程教学，帮助学生理解逻辑
  • 快速原型开发者：快速验证想法，未来支持可导出 Python 代码
  • 研究人员：需要快速搭建数据处理流程
用 NodePy 能做什么项目？ +

NodePy 适合以下类型的项目：

  • 办公自动化：Excel 批量处理、PDF 转换、文件整理
  • 数据处理：数据清洗、格式转换、统计分析、数据可视化
  • 网络请求：API 调用、网页数据抓取、批量下载
  • 文本处理：正则提取、批量替换、格式校验、文本分析
  • 学习练习：理解编程逻辑、算法可视化、Python 入门
  • 自动化脚本：文件监控、系统操作

📥 下载与安装

如何下载和安装 NodePy？ +

本地软件安装步骤：

  1. 访问官网 www.nodepy.top
  2. 点击「下载」按钮获取 node-py.zip
  3. 解压到任意目录（建议不要有中文路径）
  4. 按照使用教程文档.txt配置文件夹目录
  5. 双击node-py.exe免安装直接运行
  6. 后续更新直接官网下载最新文件，只需替换node-py.exe即可完成更新

程序开发安装：

  1. 克隆github仓库源码
  2. 打开终端/命令提示符，进入项目目录
  3. 运行 pip install -r requirements.txt 安装依赖
  4. 运行 python main.py 启动程序
提示：首次启动可能会自动下载嵌入式 Python 环境，请保持网络连接。
NodePy 支持哪些操作系统？ +

NodePy 基于 Python 和 PySide6 开发，支持主流操作系统：

  • 当前仅 Windows：Windows 10/11（推荐）

系统要求：

  • 内存 2GB+（推荐 4GB）
  • 磁盘空间 300MB+
开发端运行失败怎么办？ +

常见问题及解决方案：

  • pip 库安装失败：尝试使用国内镜像源 
    pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
  • 缺少 PySide6：手动安装 pip install PySide6>=6.5.0
  • 启动报错：检查 Python 版本是否>=3.10
  • 嵌入式环境下载失败：检查网络连接，或手动下载 Python 3.10
注意：如问题仍未解决，请加入交流群或联系作者获取技术支持。

⚙️ 功能特性

NodePy 和 Scratch 有什么区别？ +
特性NodePyScratch
目标语言PythonScratch 专有
适用人群成人/青少年儿童/青少年
应用场景办公自动化、数据处理游戏、动画、故事
代码导出可生成 Python 代码不支持
扩展能力支持自定义 Python 节点有限
学习迁移可直接过渡到 Python 编码需重新学习
NodePy 有 AI 功能吗？ +

否，无需配置主流Key，NodePy 内置生成 AI 提示词模板功能：

  • 输入函数输入
  • 输入函数功能描述
  • 输入函数输出
  • 一键生成 AI 生成函数节点提示词模板
  • 交给第三方在线 AI 完成函数代码生成
  • 复制、粘贴函数代码，创建自定义节点
提示：可使用国内任意 AI 服务接口。
NodePy 的性能如何？ +

NodePy 采用优化的执行引擎：

  • 拓扑排序：自动确定节点执行顺序，避免循环依赖
  • 批量执行：将所有节点编译成单个 Python 脚本，只调用一次 Python 解释器
  • 多线程并发：支持多线程处理列表元素，适合 I/O 密集型任务
  • 循环节点：支持区间循环、List 循环，可嵌套使用

相比逐节点执行，批量执行模式性能提升 10 倍以上。

支持哪些节点类型？ +

内置节点库（6 大类）：

  • 输出类：打印节点、日志输出
  • 常量类：布尔/整数/浮点数/字符串/列表/字典常量
  • 数据处理：数据提取、类型检测
  • 循环控制：区间循环 (Range Loop)、List 循环、多线程处理
  • 文本处理：正则提取、正则生成器
  • Debug：断点、变量监视

还支持自定义 Python 节点和节点插件导入/导出。

📖 使用教程

如何学习使用 NodePy？ +

推荐学习路径：

  1. 观看视频教程（B 站，5 分钟快速上手）
  2. 阅读官方文档
  3. 完成「四步快速开始」教程：
    • 从节点库拖拽【常量 - 字符串】到画布
    • 在右侧参数面板输入：Hello, 节点编辑器！
    • 从字符串节点输出端口拖拽到打印节点输入端口
    • 点击 ▶ 运行，底部控制台显示结果
  4. 尝试复现示例项目
  5. 创建自己的第一个流程图
如何创建自定义节点？ +

有两种方式创建自定义节点：

方式 1：AI 模板 / 自定义节点

  1. 点击工具栏「AI 模板」
  2. 参考【NodePy有 AI 功能吗？】描述步骤

方式 2：开发端代码创建

  1. 在 core/nodes/base_nodes.py 中添加函数： 
    def 乘法 (a: int, b: int) -> int:
    """
    乘法运算节点。
    输入两个数字，返回它们的乘积。
    """
    return a * b

# 保存源代码字符串（用于序列化）
乘法._source = '''def 乘法 (a: int, b: int) -> int:
    """乘法运算节点。"""
    return a * b
'''
  2. 在 core/nodes/node_library.py 中注册分类
如何保存和加载流程图？ +

保存流程图：

  1. 点击菜单栏「保存为 JSON 」
  2. 选择保存路径，输入文件名
  3. 流程图将保存为 .json 格式

加载流程图：

  1. 点击菜单栏「加载 JSON 」→可选「覆盖加载」|「增量加载」
  2. 选择之前保存的 .json 文件
  3. 流程图将加载到画布中
提示：流程图文件是 JSON 格式，可以用文本编辑器查看和编辑。
如何保存和加载节点包？ +

保存节点插件包：

  1. 点击菜单栏「导出节点插件」
  2. 选择保存路径，输入文件名
  3. 节点插件包将保存为 .json 格式

加载节点插件：

  1. 点击菜单栏「导入节点插件」
  2. 选择插件包的的 .json 文件
  3. 将节点导入到本地节点库中
提示：节点插件包文件是 JSON 格式，可以用文本编辑器查看和编辑。后续新增的系统节点插件也是使用此方式导入导出用于分享。

📜 许可与开源

NodePy 是免费的吗？ +

是的，NodePy 完全免费，采用 MIT 开源许可证。你可以：

  • 免费下载和使用（包括商业用途）
  • 查看和修改源代码
  • 分发和再发布
  • 贡献代码和改进

GitHub 仓库：github.com/Hptd/node-python

如何贡献代码？ +

欢迎贡献！方式如下：

  1. Fork 项目到你的 GitHub 账号
  2. 创建新分支：git checkout -b feature/your-feature
  3. 提交更改：git commit -m 'Add some feature'
  4. 推送分支：git push origin feature/your-feature
  5. 在 GitHub 上提交 Pull Request

贡献内容可以是：新节点、Bug 修复、文档改进、性能优化等。