Makefile 变量定义行内注释导致 scp 命令失败

2025-12-13开发环境1 分钟120 次阅读
AI 摘要鱼粮不足,AI 今天先歇着 · 正文在下面

问题描述

执行 make deploy-gateway 时,scp 命令报错:

bash 复制代码
scp s-gateway/target/s-gateway-0.0.1.jar root@47.xxx.xxx.252 :/mydata/projects/s-cloud/s-gateway/
:/mydata/projects/s-cloud/s-gateway/: No such file or directory

注意错误信息中 47.xxx.xxx.252 和 : 之间有一个空格,导致 scp 把 :/mydata/... 当作本地路径解析。

原因分析

Makefile 中变量定义如下:

makefile 复制代码
# 错误写法
PROD_HOST=47.xxx.xxx.252 # 8核2g 172.xxx.xxx.135

Makefile 的变量赋值会把 = 后面到行尾的所有内容都当作变量值,包括行内注释。

所以 $(PROD_HOST) 实际展开为:

复制代码
47.xxx.xxx.252 # 8核2g 172.xxx.xxx.135

导致 scp 命令变成:

bash 复制代码
scp xxx root@47.xxx.xxx.252 # 8核2g 172.xxx.xxx.135:/mydata/projects/s-cloud/s-gateway/

# 后面的内容被 shell 当作注释忽略,所以实际执行的是:

bash 复制代码
scp xxx root@47.xxx.xxx.252

而 :/mydata/... 被当作第三个参数(本地路径),自然找不到。

解决方案

将注释移到单独的行:

makefile 复制代码
# 正确写法
# PROD_HOST: 8核2g 内网IP 172.xxx.xxx.135
# PROD_HOST2: 2核2g 内网IP 172.xxx.xxx.137
PROD_HOST=47.xxx.xxx.252
PROD_HOST2=47.xxx.xxx.198

Makefile 注释规范

  1. 变量定义行不要使用行内注释
  2. 注释应该放在单独的行
  3. 如果必须在变量行添加说明,使用单独的注释行
makefile 复制代码
# 推荐写法
# 生产服务器1 - 8核2g - 内网IP: 172.xxx.xxx.135
PROD_HOST=47.xxx.xxx.252

# 不推荐写法(会导致问题)
PROD_HOST=47.xxx.xxx.252 # 生产服务器1

相关知识

与其他语言不同,Makefile 的变量赋值语法比较特殊:

语言 行内注释是否影响变量值
Makefile ✅ 会影响(注释被当作值的一部分)
Shell ❌ 不影响
Python ❌ 不影响
YAML ❌ 不影响
觉得有用就点个赞,不用登录也能读

评论

0 条
登录 之后才能评论
—
还没有评论,来说第一句