Python 安裝自訂模組報錯：環境變數與多版本衝突排查

常見錯誤原因

1. Python 未加入 PATH：命令列輸入 python 提示找不到命令。
2. 多版本共存衝突：系統同時安裝 Python 2.7、3.x，pip 指向錯誤版本。
3. 模組結構不符合套件規範：缺少 setup.py、__init__.py 或目錄結構錯誤。

排查步驟

1. 驗證 Python 環境：

   python --version
   python -c "import sys; print(sys.path)"

2. 確認 pip 對應版本：

   pip --version
   pip list

   若顯示 Python 2.7，改用 pip3 或 python -m pip。
3. 標準套件結構：

   my_package/
   ├── setup.py
   ├── my_package/
   │   ├── __init__.py
   │   └── module.py
   └── README.md

   setup.py 範例：

   from setuptools import setup, find_packages
   setup(
       name='my_package',
       version='0.1',
       packages=find_packages(),
       install_requires=[],
   )

4. 安裝測試：

   pip install -e .  # 開發模式安裝，修改即時生效
   # 或
   pip install .

最佳實踐

• 使用 虛擬環境 隔離專案依賴：

  python -m venv venv
  source venv/bin/activate  # Linux/Mac
  venv\Scripts\activate     # Windows
  pip install -e .

• Windows 建議安裝 Python Launcher (py.exe)，用 py -3.10 -m pip 明確指定版本。
• 發布至 PyPI 前先 pip install twine; twine check dist/* 驗證。