用 Makefile 统一项目的常用命令
【摘要】 把常用项目命令集中写进 Makefile,作为团队共享的命令入口。
为什么需要它
一个项目里常用的命令往往很多:安装依赖、跑测试、格式化、构建镜像、启动服务……这些命令散落在 README、聊天记录和个人记忆里,新同事上手时常常要四处翻找。把它们集中写进一个 Makefile,大家只需记住 make test、make run 这样简短的入口。
一个最小示例
.PHONY: install test fmt run
install:
pip install -r requirements.txt
test:
pytest -q
fmt:
black .
run:
python app.py
注意:命令前的缩进必须是 Tab,而不是空格,这是新手最常踩的坑。.PHONY 用来声明这些目标不是真实文件,避免与同名文件冲突。
几个实用技巧
- 组合目标:
check: fmt test可以一次执行格式化和测试。 - 变量:
PY ?= python3允许在命令行用make run PY=python3.12覆盖。 - 自带帮助:加一个
help目标列出所有命令,让 Makefile 本身就是文档。
小结
Makefile 并不只属于 C 语言项目。把它当作项目的命令入口,可以减少口口相传的知识,让本地开发和 CI 使用同一套命令,团队协作也更顺畅。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论(0)