Python开发企业内部轻量级工具的核心是快、稳、易维护、好交接；应避免过度设计，采用最小可行结构（main.py、config/、lib/、logs/、data/），注重打包体验、路径健壮性、依赖管理与配置分离。
用Python开发企业内部轻量级工具，核心不在于框架多高级，而在于快、稳、易维护、好交接。不需要从零造轮子，也不必上K8s——一个能被同事双击运行、出错有提示、配置可分离、日志可追溯的脚本系统，就是合格的内部工具。
明确边界：什么该做，什么不该做
内部工具不是产品，别陷入“功能完美主义”：
- 不做用户权限体系（除非真涉及敏感数据，否则用Windows域账号或简单密码文件即可）
- 不搞前后端分离（Flask/FastAPI + 简单HTML模板足够，PyQt/Gradio适合快速出界面）
- 不硬套微服务（单脚本+配置文件+日志目录，90%场景已覆盖）
- 优先复用现有环境（比如直接读写公司共享盘Excel、调用OA/ERP提供的HTTP接口或数据库视图）
结构即规范：5个必备目录和文件
哪怕只有1个.py文件，也建议按这个最小结构组织，后续扩展成本极低：
- main.py —— 入口，只做参数解析、配置加载、主逻辑调度
-
config/ —— 放
settings.yaml（用PyYAML读），含数据库连接、路径、超时等，开发/测试/生产用不同文件 -
lib/ —— 封装重复逻辑，如
db_helper.py、excel_io.py、notify.py（企微/邮件提醒） - logs/ —— 日志自动按天滚动，格式含时间、模块名、行号，错误自动发钉钉
-
data/ —— 输入输出目录（Excel模板、生成报表、缓存JSON），加
.gitignore避免误传敏感数据
让同事愿意用：3个体验细节
工具好不好用，取决于第一次运行是否顺利：
立即学习“Python免费学习笔记（深入）”；
- 打包成exe（PyInstaller）或macOS可执行包，附带
run.bat（Windows）或run.sh（Mac/Linux），双击就跑 - 首次运行自动检测缺失依赖（如openpyxl、requests），友好提示“请运行 pip install -r requirements.txt”，而不是报一长串ImportError
- 所有路径用
pathlib.Path(__file__).parent.resolve()计算，不写绝对路径；配置里的路径也支持相对路径（如input_dir: ../data/in）
上线前必做的4件事
避免“我本地能跑，别人打不开”的尴尬：
- 用
pipreqs . --encoding=utf8生成真实依赖，别靠记忆写requirements.txt - 在干净虚拟环境中重装+运行一次，确认无隐式依赖（比如误用了全局安装的包）
- 把
config/settings.yaml.example提交Git，删掉真实配置；README里写清每项含义和怎么填 - 加一个
--dry-run参数，模拟执行但不写文件/不发请求，方便测试流程是否通
基本上就这些。不复杂，但容易忽略。真正花时间的从来不是写代码，而是想清楚“谁用、在哪用、出错了找谁”。Python在这里不是炫技的工具，是把人从重复劳动里解放出来的杠杆。
