Android TextView 中 setText() 的最佳实践：告别文本拼接

在 Android 开发过程中，我们经常需要使用 TextView 来展示文本内容，setText() 方法是我们设置文本的主要途径。然而，一些开发者可能会习惯性地使用文本拼接的方式来设置文本，这实际上存在一些隐患。

直接将字符串片段拼接在一起形成最终文本，看似方便快捷，但从长远来看，这种做法会带来不少麻烦。比如，当你的应用需要支持多语言时，硬编码的拼接文本就成了翻译的障碍。翻译人员无法理解拼接的字符串片段的含义，也就无法准确地翻译成其他语言。

同样的，文本拼接也给本地化带来了困难。比如，你的文本中包含了数字或日期，这些信息在不同的地区需要以不同的格式显示。但文本拼接无法处理这些本地化的需求，导致你的应用在不同地区显示的文本格式不一致。

除此之外，文本拼接还会降低代码的可读性和可维护性。当文本内容很长或者逻辑复杂时，拼接的代码会变得难以阅读和理解，后续的修改和维护也会变得更加困难。

为了规避这些问题，我们推荐使用 Android 资源字符串和占位符来设置 TextView 的文本。

资源字符串，顾名思义，就是将字符串存储在资源文件中，也就是 res/values/strings.xml 文件中。这样做的好处是，这些字符串可以被轻松地翻译成不同的语言，而且可以在整个应用中保持一致性。

占位符则允许你在资源字符串中插入动态数据。比如，你想显示 "用户名：John Doe"，其中 "John Doe" 是一个变量。你可以定义一个资源字符串 "用户名：%s"，然后使用 getString() 方法将 "John Doe" 插入到占位符 %s 的位置。

这种方式避免了文本拼接，同时也确保了文本的格式化和本地化。因为 getString() 方法会根据当前的语言环境选择合适的翻译，并根据地区的不同格式化数字和日期等信息。

举个例子，假设你需要在 TextView 中显示商品名称和价格。你可以先在 strings.xml 文件中定义两个资源字符串：

<string name="product_name">商品名称：%s</string>
<string name="product_price">价格：%.2f</string>

然后，在代码中使用 getString() 方法设置 TextView 的文本：

val productName = "Android 手机"
val productPrice = 1999.99

productNameTextView.text = getString(R.string.product_name, productName)
productPriceTextView.text = getString(R.string.product_price, productPrice)

这样，TextView 就会显示 "商品名称：Android 手机" 和 "价格：1999.99"。

总而言之，避免在 TextView 中使用文本拼接是 Android 开发中的一项重要最佳实践。通过使用资源字符串和占位符，你可以确保你的文本能够被正确地翻译、本地化和格式化，从而提升应用的质量和可维护性。

常见问题解答

Q：如果我的文本中需要插入多个动态数据怎么办？

A： 你可以在资源字符串中使用多个占位符，例如 "姓名：%1s，年龄：%2d"。然后在 getString() 方法中按顺序传入对应的参数即可。

Q：除了 %s、%d 和 %f，还有哪些占位符可以使用？

A： Android 支持多种占位符，例如 %c (字符)、%x (十六进制数) 等。你可以在 Android 官方文档中找到完整的占位符列表。

Q：如果我的资源字符串很长，如何保证代码的可读性？

A： 你可以将长字符串拆分成多个短字符串，然后在代码中使用 + 号连接起来。或者，你也可以使用字符串模板来构建复杂的字符串。

Q：资源字符串和占位符是否会影响应用的性能？

A： 资源字符串和占位符对应用性能的影响微乎其微，你可以放心使用。

Q：除了 TextView，其他控件是否也应该避免使用文本拼接？

A： 是的，其他需要显示文本的控件，例如 Button、EditText 等，也应该避免使用文本拼接，并采用资源字符串和占位符的方式来设置文本。