17370845950

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个体验细节

工具好不好用，取决于第一次运行是否顺利：

• 打包成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在这里不是炫技的工具，是把人从重复劳动里解放出来的杠杆。