在 PyCharm 中使用这些拆分后的 `.py` 文件，并确保你可以调用全部功能模块，需要正确配置项目结构和 Python 解释器路径。以下是详细的步骤说明，帮助你在 **PyCharm** 中顺利运行这个多文件的 Gibbs 图分析软件。 --- ## ✅ 第一步：创建或打开项目 1. 打开 PyCharm。 2. 选择 **"Open"** 或 **"New Project"**： - 如果已有项目文件夹：点击 **"Open"**，选择你存放所有 `.py` 文件的文件夹（如 `gibbs_app/`）。 - 如果是新建项目：选择 **"New Project"**，设置位置为 `gibbs_app`，然后继续。 > 📁 建议你的项目目录结构如下： ``` gibbs_app/ │ ├── main.py ├── app.py ├── ui_components.py ├── data_manager.py ├── plot_manager.py └── __init__.py （可选，用于标记为包） ``` --- ## ✅ 第二步：确认 Python 解释器设置 PyCharm 必须使用正确的 Python 环境，包含所需库（pandas, matplotlib, numpy, openpyxl）。 ### 操作步骤： 1. 进入菜单：**File → Settings**（Windows/Linux），或 **PyCharm → Preferences**（macOS）。 2. 导航到：**Project → Python Interpreter**。 3. 查看右侧是否已安装以下包： - `pandas` - `matplotlib` - `numpy` - `openpyxl`（用于读写 `.xlsx` 文件） ### 若缺少依赖，请安装： - 在 PyCharm 右上角有 `+` 号按钮，点击后搜索并安装上述库。 - 或者在终端中执行： ```bash pip install pandas matplotlib numpy openpyxl ``` > 💡 提示：PyCharm 内置终端可用（底部标签页 "Terminal"）。 --- ## ✅ 第三步：将主文件设为运行入口 我们将以 `main.py` 作为程序启动文件。 ### 设置方法： 1. 在左侧项目面板双击打开 `main.py`。 2. 右键单击编辑器中的代码区域 → 选择 **"Run 'main'"**。 3. PyCharm 会自动创建一个运行配置（Run Configuration）。 ✅ 成功运行后，你会看到 GUI 窗口弹出，包含表格、按钮和绘图区。 --- ## ✅ 第四步：解决可能的导入错误（Import Errors） 由于我们把功能拆成了多个模块，Python 需要知道如何找到它们。 ### 常见报错示例： ```python ModuleNotFoundError: No module named 'app' ``` ### 解决方案：设置源根（Sources Root） 告诉 PyCharm 把当前项目目录视为“源代码根目录”，这样所有相对导入都能正常工作。 #### 操作步骤： 1. 在左侧项目视图中，右键点击你的项目文件夹（如 `gibbs_app`）。 2. 选择 **"Mark Directory as" → "Sources Root"**。 👉 此时该文件夹会变成蓝色图标，表示已被识别为源路径。 ✅ 完成后，所有 `from app import ...`、`import data_manager` 等语句都会被正确解析。 --- ## ✅ 第五步：运行与调试 现在你可以在 PyCharm 中： | 功能 | 方法 | |------|------| | 🔹 运行程序 | 点击 `main.py` 中的绿色三角 ▶️ 按钮 | | 🔹 调试程序 | 点击“虫子”图标进行断点调试 | | 🔹 修改任意模块 | 如修改 `plot_manager.py` 中的颜色或曲线公式，保存后重新运行即可生效 | | 🔹 实时查看输出 | 底部 "Run" 面板显示 print 输出和异常信息 | --- ## ✅ 示例：测试所有功能模块是否可用 你可以依次验证以下功能是否正常： | 功能 | 测试方式 | |------|--------| | ✅ 添加数据行 | 点击 “添加数据行” 按钮 → 表格新增一行默认值 | | ✅ 编辑单元格 | 双击任意数值或类别 → 修改内容并保存 | | ✅ 删除/清空数据 | 选中行 → 删除；或清空全部 | | ✅ 导入 Excel 数据 | 准备一个含四列的 `.xlsx` 文件 → 点击导入 | | ✅ 绘制 Gibbs 图 | 点击 “生成Gibbs图” → 查看右侧图表是否显示散点和曲线 | | ✅ 保存图片 | 点击 “保存图片” → 选择路径导出 PNG/PDF | --- ## ✅ 小技巧：启用自动导入提示 为了让 PyCharm 更好地提示函数和类： 1. 打开任意 `.py` 文件。 2. 使用快捷键 `Alt + Enter` 放在未识别的变量上，PyCharm 会建议导入来源。 3. 开启 **"Auto-import"** 功能（Settings → Editor → General → Auto Import）。 --- ## ✅ 附加建议：添加 `__init__.py`（可选） 虽然不是必须，但为了兼容性更好，可在项目根目录加一个空的： ```python # __init__.py # 让 Python 将此目录识别为包（适用于复杂项目） ``` --- ## ✅ 总结：PyCharm 使用要点清单 | 步骤 | 是否完成？ | |------|----------| | ✅ 创建项目并放入所有 `.py` 文件 | ☐ | | ✅ 安装 `pandas`, `matplotlib`, `numpy`, `openpyxl` | ☐ | | ✅ 标记项目根目录为 "Sources Root" | ☐ | | ✅ 从 `main.py` 启动程序 | ☐ | | ✅ 测试所有按钮和绘图功能 | ☐ | 只要以上都完成，你就可以在 PyCharm 中 **完整调用所有功能模块**！ ---