用 Makefile 统一项目的常用命令

举报
yd_273709801 发表于 2026/11/08 11:36:49 2026/11/08
【摘要】 把常用项目命令集中写进 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)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。