一文教你如何解决Python开发总是import出错的问题

# 初始化项目结构
mkdir my_packagjse && cd my_package
touch setup.py  # 包含包元数据（名称、版本、依赖等）

# 安装可编辑模式
pip install -e .

# pyproject.toml 示例
[build-system]
requires = ["setuptools>=42", "wheel"]
build-backend = "setuptools.build_meta"

[project]
name = "my_package"
version = "0.1.0"
dependencies = ["requests>=2.25"]

# 使用 PEP 660 标准安装
pip install -e .

[build-system]
requires = ["setuptools>=61.0", "wheel"]
build-backend = "setuptools.build_meta"

[project]
name = "Tdouya-AI-Assistant"          #  用户指定项目名称
version = "0.1.1"
authors = [{name = "田辛老师", email = "tianxin.xp@gmail.com"}]  #  用户信息
description = "基于AI的智能助手开发框架"
readme = "README.md"
requires-python = ">=3.12"

[tool.setuptools]
package-dir = { "" = "src" }  # 声明包根目录在src下

from setuptools import setup, find_packages

setup(
    name="Tdouya-AI-Assistant",  #  必须与pyproject.toml一致
    version="0.1.1",
    author="田辛老师",
    author_email="tianxin.xp@gmail.com",
    description="基于AI的智能助手开发框架",
    packages=find_packages(where="src"),  China编程# 指定包搜索路径
    package_dir={"": "src"},  # 声明包根目录
    install_requires=[
        "python-dotenv>=0.19.0", 
        "requests>=2.21.0",  
        "streamlit>=1.0.0", 
        "moviepy>=1.0.3",  
        "colorlog>=6.7.0",
        "langchain_ollama",
        "langchain_core",
        "langchain_community",
        "ollama",
        "dashscope"
    ],
    python_requires=">=3.12",
)

pip install -e .

# ==============================================
# 文件名: init.py
# 描述: 此脚本用于查找项目根路径，若项目未初始化则进行初始化操作，已初始化则给出提示。
# 作者: 田辛
# 创建日期: 2025-05-07China编程
# ==============================================
# 导入操作系统相关功能模块，用于文件和目录操作
import os

# 导入子进程模块，用于创建新进程执行外部命令
import subprocess

# 导入系统相关功能模块，用于获取Python解释器信息
import sys

# 导入日期时间模块，用于获取当前时间
import datetime

# 获取当前脚本所在的绝对路径目录
script_dir = os.path.dirname(os.path.abspath(__file__))
# 初始化当前搜索目录为脚本所在目录
current_dir = script_dir

while True:
    # 定义项目已初始化时所需的文件列表
    required_files = [
        "setup.py",
        "pyproject.toml",
        "README.md",
        "CONTRIBUTING.md",
        "installed.lock",
    ]
    # 检查当前目录是否存在所有已初始化所需的文件
    if all(os.path.isfile(os.path.join(current_dir, f)) for f in required_files):
        print(
            f"田豆芽AI助手已安装， 若想再次安装请先卸载。卸载命令：python {script_dir}/uninstall.py"
        )
        break
    # 定义项目未初始化时所需的文件列表
    original_required_files = [
        "setup.py",
        "pyproject.toml",
        "README.md",
        "CONTRIBUTING.md",
    ]
    # 检查当前目录是否存在所有未初始化所需的文件
    if all(
        os.path.isfile(os.path.join(current_dir, f)) for f in original_required_files
    ):
        try:
            # 切换当前工作目录到项目根路径
            os.chdir(current_dir)
            # 使用当前Python解释器执行 `pip install -e .` 命令进行项目安装
            result = subprocess.run(
                [sys.executable, "-m", "pip", "install", "-e", "."],
                capture_output=True,
                text=True,
                check=True,
            )
            print(result.stdout)
            # 生成锁定文件路径
            lock_file_path = os.path.join(current_dir, "installed.lock")
            # 打开锁定文件并写入当前时间戳
            with open(lock_file_path, "w") as f:
                f.write(datetime.datetime.now().strftime("%Y%m%d %H:%M:%S"))
            print(f"田豆芽AI助手安装完成。")
        except subprocess.CalledProcessError as e:
            # 捕获子进程执行错误并输出错误信息
            print(f"执行 `pip install -e .` 命令时出错: {e.stderr}")
        except Exception as e:
            # 捕获其他异常并输出错误信息
            print(f"执行命令时出错: {e}")
        break
    else:
        # 获取当前目录的上一级目录
        new_dir = os.path.dirname(current_dir)
        # 检查是否已经回到根驱动器，如果是则表示未找到项目根路径
        if new_dir == current_dir[:3]:
            print("未找到项目根路径。")
            break
        # 更新当前搜索目录为上一级目录
        current_dir = new_dir

# ==============================================
# 文件名: uninstall.py
# 描述: 此脚本用于查找项目根路径，执行卸载操作并删除锁定文件。
# 作者: 田辛
# 创建日期: 2025-05-07
# ==============================================
import os
import subprocess
import sys

# 获取当前脚本所在的绝对路径目录
script_dir = os.path.dirname(os.path.abspath(__file__))
# 初始化当前搜索目录为脚本所在目录
current_dir = script_dir

while True:
    # 定义项目已初始化时所需的文件列表
    required_files = [
        "setup.py",
        "pyproject.toml",
        "README.md",
        "CONTRIBUTING.md",
        "installed.lock",
    ]
    # 检查当前目录是否存在所有已初始化所需的文件
    if all(os.path.isfile(os.path.join(current_dir, f)) for f in required_files):
        try:
            # 切换当前工作目录到项目根路径
            os.chdir(current_dir)
            # 执行pip uninstall命令
            result = subprocess.run(
                [sys.executable, "-m", "pip", "uninstall", "-y", "Tdouya-AI-Assistant"],
                capture_output=True,
                text=True,
                check=True,
            )
            print(result.stdout)
            # 删除锁定文件
            lock_file_path = os.path.join(current_dir, "installed.lock")
            if os.path.isfile(lock_file_path):
                os.remove(lock_file_path)

            print("田豆芽AI助手卸载成功。")
        except subprocess.CalledProcessError as e:
            # 捕获子进程执行错误并输出错误信息
            print(f"执行 `pip uninstall Tdouya-AI-Assistant` 命令时出错: {e.stderr}")
        except Exception as e:
            # 捕获其他异常并输出错误信息
            print(f"执行命令时出错: {e}")
        break
    else:
        # 获取当前目录的上一级目录
        new_dir = os.path.dirname(current_dir)
        # 检查是否已经回到根驱动器，如果是则表示未找到项目根路径
        if new_dir == current_dir[:3]:
            print("未找到项目根路径。")
            break
        # 更新当前搜索目录为上一级目录
        current_dir = new_dir