🆔 FormatCWEID — 将 CWE ID 字符串格式化为标准形式

📋 函数签名

func FormatCWEID(id string) (string, error)

📖 说明

FormatCWEID 把任意合规写法的 CWE ID 统一为 MITRE 官方标准形式 CWE-NNN：去空格、统一大写、数字去前导零。它内部先调用 ParseCWEID 取得整数，再用 fmt.Sprintf("CWE-%d", num) 输出。

与 FormatCWEIDFromInt 的区别

• 本函数输入是字符串，需做解析与校验，可能返回错误。
• FormatCWEIDFromInt 输入是 int，绝不报错，适合已知是合法整数的场景。

📥 参数

参数	类型	说明
id	string	需要格式化的 CWE ID 字符串

📤 返回值

返回值	类型	说明
标准形式	string	形如 CWE-79；失败时为空串 ""
error	error	输入不合法时返回 InvalidCWEIDError

✅ 示例

package main

import (
	"fmt"
	cweskills "github.com/scagogogo/cwe-skills"
)

func main() {
	cases := []string{"79", "cwe-79", "CWE79", "CWE 79", "cwe-079"}
	for _, c := range cases {
		out, err := cweskills.FormatCWEID(c)
		fmt.Printf("%-10q => %q, %v\n", c, out, err)
	}
	// "79"       => "CWE-79", <nil>
	// "cwe-79"   => "CWE-79", <nil>
	// "CWE79"    => "CWE-79", <nil>
	// "CWE 79"   => "CWE-79", <nil>
	// "cwe-079"  => "CWE-79", <nil>

	_, err := cweskills.FormatCWEID("")
	fmt.Println(err) // InvalidCWEIDError
}

⚠️ 常见错误

失败时返回空串

当输入无法解析时，返回的第一个值是空字符串 ""。务必先检查 error 再使用返回值，避免把空串带入下游逻辑。

典型误用：忽略错误直接使用

// ❌ 错误示范
id, _ := cweskills.FormatCWEID(userInput)
query := "SELECT * FROM cwe WHERE id = '" + id + "'"
// userInput 非法时 id 为 ""，可能拼出非法 SQL

// ✅ 正确做法
id, err := cweskills.FormatCWEID(userInput)
if err != nil {
    return fmt.Errorf("无效的 CWE ID: %w", err)
}

🔗 相关链接

• 底层依赖：ParseCWEID
• 整数版本：FormatCWEIDFromInt
• 错误类型：InvalidCWEIDError
• 源文件：cwe_utils.go