如何用setuptools打包含单个模块的Flask应用及CSS文件？

你遇到的核心问题是data_files配置的局限性——它会把文件安装到系统级的公共目录，而非和你的Flask模块放在一起，导致运行时找不到CSS文件。下面是具体的修复方案：

1. 重构目录为标准Python包结构 #

首先把文件整理成标准包结构，让setuptools能正确识别并打包静态资源：

app_repo/
  --> myapp/
      --> __init__.py       # 空文件即可，标记这是一个Python包
      --> flask_app.py
      --> custom.css
  --> setup.py
  --> MANIFEST.in

2. 修改setup.py配置 #

替换原setup.py内容，改用packages和package_data指定要打包的静态文件：

from setuptools import setup

setup(
    name='myapp',
    version='1',
    packages=['myapp'],  # 告诉setuptools打包这个包目录
    package_data={
        'myapp': ['custom.css'],  # 指定myapp包下要包含的静态文件
    },
    include_package_data=True,  # 配合MANIFEST.in确保文件被纳入打包范围
    entry_points={'console_scripts': ['runapp = myapp.flask_app:app.run_server']},  # 更新模块路径
)

3. 配置MANIFEST.in #

在MANIFEST.in中添加以下内容，确保打包工具能捕获到CSS文件：

include myapp/custom.css

4. 调整Flask应用中CSS文件的引用路径 #

现在CSS文件在包目录内，需要用pkg_resources获取它的绝对路径，避免运行时找不到：
在flask_app.py中添加：

from pkg_resources import resource_filename

# 获取CSS文件的绝对路径
css_file_path = resource_filename('myapp', 'custom.css')

之后就可以用这个路径读取或引用CSS文件了。

为什么原来的配置不行？ #

data_files=[('', ['custom.css'])]会把custom.css安装到系统默认的数据目录（比如虚拟环境的share目录），而非和flask_app.py同目录。而package_data的方式会把CSS文件和你的包模块一起安装到site-packages目录下，路径对应，就能被正确访问了。

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