Android语言基础教程（127）Android字符串（string）资源之使用字符串资源：别让你的字符串在代码里“裸奔”！

原创 于 2025-11-10 08:31:22 发布 · 342 阅读 · 9 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#android #gitee #vscode

朋友们，今天咱们来聊聊Android开发中最“不起眼”却最“要命”的部分——字符串资源。我敢打赌，至少80%的开发者在职业生涯早期都干过这种事：

TextView textView = findViewById(R.id.textview);
textView.setText("你好，世界！"); // 这行代码看起来人畜无害，实则后患无穷

然后产品经理笑眯眯地走过来说：“小王啊，咱们App要出海了，做个英文版呗~”

此刻的你，望着代码里密密麻麻的“你好”、“确定”、“取消”，是不是很想穿越回去给当时的自己一个大比兜？

别问我怎么知道的，说多了都是泪…

一、字符串资源：不只是“翻译”那么简单

1.1 为什么要把字符串从代码里“请”出去？

首先，咱们得明白Google为啥要大费周章地搞个strings.xml出来。这可不是程序员们闲着蛋疼：

  • 国际化（i18n）准备：你的App今天可能只服务中文用户，明天说不定就走向世界了。提前把字符串集中管理，后续加个英文版、日文版，就是复制粘贴的事儿
  • 一致性维护：同一个App里，“确定”按钮有的地方写“确定”，有的地方写“确认”，用户体验就跟坐过山车一样。统一管理后，改一处则处处改
  • 动态适配：同样一个“删除”操作，在手机上可能直接显示，在平板上可能需要在上下文菜单里，字符串资源让这种适配变得轻松

1.2 strings.xml——你的字符串“大本营”

来，看看标准的strings.xml长啥样：

<resources>
    <string name="app_name">我的超级App</string>
    <string name="welcome_message">你好，%s！欢迎回来~</string>
    <string name="notification_count">你有%d条新消息</string>
</resources>

这玩意一般住在res/values/strings.xml里。但等等，这只是默认配置，真正的威力在于你可以为不同语言创建不同的values文件夹：

  • res/values/strings.xml（默认，比如英文）
  • res/values-zh/strings.xml（中文）
  • res/values-ja/strings.xml（日文）

系统会根据用户手机的语言设置，自动选择对应的字符串文件。是不是很贴心？

二、基础操作：从“青铜”到“王者”

2.1 在布局文件中使用——最直接的姿势

在XML布局里引用字符串资源，简单到令人发指：

<TextView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="@string/welcome_message" />

注意那个@string/前缀，这是告诉系统：“嘿，哥们，去strings.xml里找我定义的字符串！”

2.2 在代码中动态使用——灵活性的体现

有时候我们需要根据业务逻辑动态设置文本，这时候就要在Java/Kotlin代码中操作了：

// Java版本
TextView welcomeText = findViewById(R.id.welcome_text);
welcomeText.setText(getString(R.string.welcome_message));

// Kotlin版本（更简洁）
val welcomeText: TextView = findViewById(R.id.welcome_text)
welcomeText.text = getString(R.string.welcome_message)

2.3 带参数的字符串——让文本“活”起来

这是很多新手容易忽略的进阶技巧！想象一下这样的场景：需要在不同地方欢迎不同用户。

笨办法：

textView.setText("你好，" + username + "！欢迎回来~");

聪明人的做法：

<string name="welcome_message">你好，%1$s！欢迎回来~</string>

使用时：

String message = getString(R.string.welcome_message, username);
textView.setText(message);

看到区别了吗？第一种方式把用户名硬编码进去，如果要做多语言适配，语序调整会要了你的命。而第二种方式，翻译人员只需要调整占位符位置就行了：

英文版可能是：<string name="welcome_message">Welcome back, %1$s!</string>

参数类型说明：

  • %s：字符串
  • %d：整数
  • %f：浮点数
  • %1$s、%2$d：带位置的参数（推荐使用，可以调整顺序）
三、花式玩法：让你的字符串“秀”起来

3.1 HTML样式字符串——有限的富文本支持

有时候我们想让部分文字加粗、变色，但又不想大动干戈用多个TextView，这时候HTML字符串就派上用场了：

<string name="rich_text"><![CDATA[欢迎使用<b>加粗文本</b>和<font color="#FF0000">红色文字</font>]]></string>

在代码中处理：

TextView richTextView = findViewById(R.id.rich_text);
richTextView.setText(Html.fromHtml(getString(R.string.rich_text), Html.FROM_HTML_MODE_LEGACY));

注意：Android对HTML支持有限，不是所有标签都有效，而且性能上有一定开销，不要滥用。

3.2 字符串数组——列表数据的福音

还在为列表项的固定文本头疼？字符串数组了解一下：

<string-array name="week_days">
    <item>星期一</item>
    <item>星期二</item>
    <item>星期三</item>
    <item>星期四</item>
    <item>星期五</item>
    <item>星期六</item>
    <item>星期日</item>
</string-array>

使用起来超级简单：

String[] days = getResources().getStringArray(R.array.week_days);

3.3 数量字符串（Plurals）——解决英文复数的“神器”

这个功能主要为了解决英文中的单复数问题，虽然中文里不太需要，但如果你做国际化，这是必须掌握的：

<plurals name="message_count">
    <item quantity="one">你有 %d 条新消息</item>
    <item quantity="other">你有 %d 条新消息</item>
</plurals>

使用：

int count = 1;
String message = getResources().getQuantityString(R.plurals.message_count, count, count);

当count为1时显示第一条，大于1时显示第二条。虽然中文里单复数形式一样，但为了规范，还是要写完整。

四、实战演练：完整登录页面示例

光说不练假把式，下面我们用一个完整的登录页面来演示字符串资源的实际应用：

4.1 strings.xml 内容

<resources>
    <!-- 基础字符串 -->
    <string name="app_name">我的App</string>
    <string name="login_title">用户登录</string>
    <string name="username_hint">请输入用户名</string>
    <string name="password_hint">请输入密码</string>
    <string name="login_button">登录</string>
    <string name="register_prompt">还没有账号？<font color="#2196F3">立即注册</font></string>
    
    <!-- 带参数字符串 -->
    <string name="login_success">欢迎回来，%s！</string>
    <string name="login_attempt">登录尝试剩余次数：%d</string>
    
    <!-- 字符串数组 -->
    <string-array name="login_types">
        <item>密码登录</item>
        <item>验证码登录</item>
        <item>指纹登录</item>
    </string-array>
</resources>

4.2 activity_login.xml 布局

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:padding="20dp">

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="@string/login_title"
        android:textSize="24sp"
        android:layout_gravity="center_horizontal"
        android:layout_marginBottom="30dp" />

    <Spinner
        android:id="@+id/login_type_spinner"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:entries="@array/login_types" />

    <EditText
        android:id="@+id/username_edittext"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginTop="20dp"
        android:hint="@string/username_hint" />

    <EditText
        android:id="@+id/password_edittext"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginTop="10dp"
        android:hint="@string/password_hint"
        android:inputType="textPassword" />

    <Button
        android:id="@+id/login_button"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginTop="20dp"
        android:text="@string/login_button" />

    <TextView
        android:id="@+id/register_prompt"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center_horizontal"
        android:layout_marginTop="15dp"
        android:text="@string/register_prompt" />

</LinearLayout>

4.3 LoginActivity.java 逻辑代码

public class LoginActivity extends AppCompatActivity {
    
    private EditText usernameEditText;
    private EditText passwordEditText;
    private TextView registerPrompt;
    private int attemptCount = 3;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_login);
        
        initViews();
        setupClickListeners();
    }

    private void initViews() {
        usernameEditText = findViewById(R.id.username_edittext);
        passwordEditText = findViewById(R.id.password_edittext);
        registerPrompt = findViewById(R.id.register_prompt);
        
        // 设置HTML文本
        registerPrompt.setText(Html.fromHtml(getString(R.string.register_prompt), Html.FROM_HTML_MODE_LEGACY));
    }

    private void setupClickListeners() {
        findViewById(R.id.login_button).setOnClickListener(v -> attemptLogin());
        
        // 注册文本点击事件
        registerPrompt.setOnClickListener(v -> {
            Toast.makeText(this, "跳转到注册页面", Toast.LENGTH_SHORT).show();
        });
    }

    private void attemptLogin() {
        String username = usernameEditText.getText().toString();
        String password = passwordEditText.getText().toString();
        
        // 模拟登录验证
        if ("admin".equals(username) && "123456".equals(password)) {
            // 登录成功，使用带参数字符串
            String successMessage = getString(R.string.login_success, username);
            Toast.makeText(this, successMessage, Toast.LENGTH_LONG).show();
        } else {
            // 登录失败
            attemptCount--;
            if (attemptCount > 0) {
                // 使用带数字参数的字符串
                String attemptMessage = getString(R.string.login_attempt, attemptCount);
                Toast.makeText(this, attemptMessage, Toast.LENGTH_SHORT).show();
            } else {
                Toast.makeText(this, "登录失败次数过多，请稍后再试", Toast.LENGTH_LONG).show();
                findViewById(R.id.login_button).setEnabled(false);
            }
        }
    }
}
五、避坑指南与最佳实践

5.1 常见坑点提醒

  • 别忘了Context：在非Activity类中使用getString()时，需要传递Context参数
  • HTML安全：使用Html.fromHtml()处理用户输入的内容时，注意XSS安全风险
  • 性能考虑：避免在频繁调用的方法（如getView）中处理复杂的字符串格式化

5.2 推荐做法

  1. 命名规范：使用小写+下划线的命名方式，如login_button_confirm
  2. 分类管理：大型项目可以按模块拆分strings.xml
  3. 及时清理：定期清理不再使用的字符串资源
  4. 注释完善：给复杂的字符串资源添加注释，说明使用场景和参数含义
结语

字符串资源看似简单，实则是Android开发中不可或缺的基础设施。从今天开始，告别硬编码，让你的字符串“住进”该住的地方。记住，专业的开发者不是从能写出多复杂的逻辑判断的，而是从这些基础规范开始的。

现在就去检查一下你的项目，把那些“裸奔”的字符串一个个“请”进strings.xml吧！你的未来国际化版本会感谢现在的你。

（偷偷告诉你，规范的字符串管理在面试时也是加分项哦，亲测有效！）

评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

值引力

持续创作，多谢支持！

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值