咨询Windows CMD运行带自定义模块的Python程序的命令参数

Hey there! Let's work through your problem step by step—this is a super common issue when moving from IDE runs to command line or packaging, so you're not alone.

Fixing the "missing package" error in Windows CMD #

The reason Eclipse PyDev runs your code fine is that it automatically adds your project's root directory to Python's sys.path (the list of places Python looks for modules/packages). When you run python main.py directly in CMD, that path isn't included by default, so Python can't find your custom packages. Here are a few solid solutions:

1. Temporarily set the PYTHONPATH environment variable #

If your project root is something like C:\Projects\WebScraper, run this in CMD first:

set PYTHONPATH=C:\Projects\WebScraper

Then run your script normally:

python main.py

You can even combine it into one line to save time:

set PYTHONPATH=C:\Projects\WebScraper && python main.py

2. Add the project root to sys.path in your code (permanent fix) #

This is my favorite approach because it makes your script runnable anywhere, no CMD setup needed. Add this at the very top of main.py:

import sys
import os

# Get the absolute path of the directory containing main.py
script_dir = os.path.dirname(os.path.abspath(__file__))
# If main.py is directly in your project root, script_dir is the root—adjust if it's in a subfolder (e.g., os.path.dirname(script_dir) if it's in a src folder)
project_root = script_dir

# Add the project root to Python's path if it's not already there
if project_root not in sys.path:
    sys.path.insert(0, project_root)

Now Python will always look in your project root for your packages, whether you run it in PyDev or CMD.

3. Run as a module with the -m flag #

If your main.py is part of a package (e.g., inside a src folder that has an __init__.py file), you can run it from the project root like this:

python -m src.main

This tells Python to treat src.main as a module and automatically adds the project root to sys.path.

Preparing for PyInstaller to build an .exe #

Once your script runs smoothly in CMD, packaging it with PyInstaller is the next step. Here's what you need to know:

First, install PyInstaller if you haven't already:

pip install pyinstaller

Basic packaging command #

From your project root, run:

pyinstaller main.py

This will create a dist folder with your .exe and all the necessary dependencies.

Key flags for better packaging #

• Single-file exe: If you want a single standalone .exe (instead of a folder full of files), use the -F flag:

  pyinstaller -F main.py
  

  Note: Single-file exes take a bit longer to start up because they extract themselves to a temporary folder first.

• Including external resources: If your scraper uses config files, templates, or other assets, you need to tell PyInstaller to include them with --add-data. For Windows, use a semicolon to separate the source and destination paths:

  pyinstaller --add-data "config.ini;." -F main.py
  

  This copies config.ini into the same folder as the exe (or the temporary folder for single-file builds). To access these resources correctly in your code, use a helper function like this:

  def get_resource_path(relative_path):
      try:
          # PyInstaller sets this to the temp folder where assets are extracted
          base_path = sys._MEIPASS
      except Exception:
          # Fallback to the normal path when running outside PyInstaller
          base_path = os.path.dirname(os.path.abspath(__file__))
      return os.path.join(base_path, relative_path)
  
  # Use it like this
  config_file = get_resource_path("config.ini")
  

• Hidden imports: If PyInstaller misses one of your custom packages, use --hidden-import to explicitly include it:

  pyinstaller --hidden-import your_custom_package -F main.py
  

内容的提问来源于stack exchange，提问作者Lafayette