明白了！你有一个非常典型的 **受限环境**：只能使用
Python 标准库（不能
安装 `lxml`、`xmltodict` 等第三方包），也不能依赖外部工具，但需要处理 XML 文件并 **保留注释**。
而标准库 `xml.etree.ElementTree` 的致命缺陷是：**它会丢弃所有 XML 注释节点**，导致你的版权信息和内联注释全部丢失。
---
## ✅
解决方案：不解析整个 XML，仅用字符串/正则替换版本号
### 🔑 核心思想：
> 既然 `ElementTree` 必然破坏注释，那就 **完全绕过 XML 解析器**，直接以文本方式安全地修改目标属性值。
我们只对特定 `<property>` 标签的内容进行精确匹配与替换，保持文件其余部分（包括注释、格式、结构）**原封不动**。
---
### ✅ 改进后的纯标准库方案（无需第三方包）
```
python
import os
import re
# 定义要更新的属性名和对应的 skip 环境变量映射
VERSION_PROPERTIES = {
'omada.local.api.version': 'skip_omada_parent',
'omada.components.version': 'skip_omada_components',
'omada.devicegateway.api.version': 'skip_omada_device_gateway_api',
'omada.manager.api.version': 'skip_omada_manager_api',
'omada.client.api.version': 'skip_omada_client_api',
'omada.identityaccess.api.version': 'skip_omada_identityaccess_api',
'omada.logmanager.api.version': 'skip_omada_log_api',
'omada.monitor.api.version': 'skip_omada_monitor_api',
'omada.maintenance.api.version': 'skip_omada_maintenance_api',
'omada.insight.api.version': 'skip_omada_insight_api',
'client.central.api.version': 'skip_omada_starter_api',
}
def parse_version(version_str):
"""解析版本字符串，返回 (base_parts, is_snapshot)"""
if version_str.endswith('-SNAPSHOT'):
return version_str[:-9], True
return version_str, False
def increment_version(base_version):
"""将版本号的最后一部分 +1，例如 6.1.0.100 -> 6.1.0.101"""
try:
parts = list(map(int, base_version.split('.')))
parts[-1] += 1
return '.'.join(map(str, parts))
except Exception as e:
raise ValueError(f"无法解析版本号: {base_version}") from e
def should_skip(skip_env_var):
"""检查环境变量是否为 true（不区分大小写）"""
return os.getenv(skip_env_var, '').strip().lower() == 'true'
def update_pom_version(pom_path):
"""以文本模式更新 pom.xml 中指定属性的版本号，保留注释和原始格式"""
with open(pom_path, 'r', encoding='utf-8') as f:
content = f.read()
modified = False
updated_content = content
for prop_name, skip_env in VERSION_PROPERTIES.items():
# 构造匹配该 property 的正则表达式
# 匹配：<prop_name>xxx</prop_name> 或 <prop_name>xxx-SNAPSHOT</prop_name>
pattern = rf'<{re.escape(prop_name)}>([^<]+)</{re.escape(prop_name)}>'
match = re.search(pattern, updated_content)
if not match:
print(f"警告: 未找到属性 {prop_name}")
continue
old_value = match.group(1).strip()
base_version, is_snapshot = parse_version(old_value)
# 检查是否跳过
if should_skip(skip_env):
print(f"跳过 {prop_name}（环境变量 {skip_env}=true）")
continue
if is_snapshot and should_skip('skip_snapshot'):
print(f"跳过 {prop_name}（SNAPSHOT 且 skip_snapshot=true）")
continue
# 执行自增
new_base = increment_version(base_version)
new_value = f"{new_base}-SNAPSHOT" if is_snapshot else new_base
# 替换旧值为新值（只替换第一个匹配项）
old_tag = f"<{prop_name}>{old_value}</{prop_name}>"
new_tag = f"<{prop_name}>{new_value}</{prop_name}>"
updated_content = updated_content.replace(old_tag, new_tag, 1)
print(f"{prop_name}: {old_value} -> {new_value}")
modified = True
if modified:
with open(pom_path, 'w', encoding='utf-8') as f:
f.write(updated_content)
print(f"\n✅ 已成功更新 {pom_path} 并保留所有注释和格式")
else:
print("❌ 无任何修改发生")
```
---
### ✅ 这个方案的优点：
| 特性 | 是否满足 |
|------|---------|
| ✅ 不依赖任何
第三方库 | ✔️ |
| ✅ 完全保留原始注释（顶部版权、内联说明） | ✔️ |
| ✅ 不改变文件缩进、换行、空格等格式 | ✔️ |
| ✅ 修改精准，不影响其他内容 | ✔️ |
| ✅ 兼容 Windows Batch 调用 | ✔️ |
---
### 🧪 示例效果
原始内容片段：
```xml
<!--api版本-->
<omada.local.api.version>6.1.0.100-SNAPSHOT</omada.local.api.version>
```
执行后变成：
```xml
<!--api版本-->
<omada.local.api.version>6.1.0.101-SNAPSHOT</omada.local.api.version>
```
✅ 注释还在
✅ 格式不变
✅ 只改了数字
---
### ⚠️ 注意事项
1. **确保标签是单行形式**
此
方法假设每个 `<xxx>value</xxx>` 是一行或连续文本。如果属性跨多行如：
```xml
<omada.local.api.version>
6.1.0.100-SNAPSHOT
</omada.local.api.version>
```
则需增强正则（见下方扩展）。
2. **避免重复属性名冲突**
如果同一个属性出现多次，只会替换第一次。建议确认 POM 中唯一性。
3. **正则转义安全**
使用 `re.escape(prop_name)` 防止特殊字符
出错。
---
### 🔁 增强版正则（支持跨行标签）
如果你的 POM 属性可能跨行，可以用以下更健壮的正则：
```
python
pattern = rf'<{re.escape(prop_name)}>\s*([^<\s][^<]*)\s*</{re.escape(prop_name)}>'
```
或者启用 `re.DOTALL` 模式来匹配换行：
```
python
match = re.search(pattern, updated_content, re.DOTALL)
```
示例：
```
python
pattern = rf'<{re.escape(prop_name)}>(.*?)</{re.escape(prop_name)}>'
match = re.search(pattern, updated_content, re.DOTALL)
if match:
old_value = match.group(1).strip() # 去掉前后空白
```
这样就能处理：
```xml
<omada.local.api.version>
6.1.0.100-SNAPSHOT
</omada.local.api.version>
```
---
### ✅ 最终建议
在你当前限制条件下，**最佳实践就是放弃 XML 解析，改用“智能文本替换”策略**。
这个方案简单、可靠、零依赖，
完美适配 CI/CD 脚本、批处理调用场景。
---
订阅专栏 解锁全文
扫一扫
1447
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
