# نوشتن در فایل با استفاده از Bash

- پیوند: https://negarnovin.com/docs/how-to-write-to-a-file-in-bash/
- منتشرشده: 2025-09-08T13:02:59+00:00
- نویسنده: نگارنوین

# نحوه نوشتن در فایل در Bash

روش های مختلف نوشتن در فایل ها در Bash، از جمله تغییر مسیر، tee، Heredoc، حلقه ها
و توصیف گرهای فایل را بیاموزید.

 

نوشتن در فایل ها یک کار اساسی در اسکریپت نویسی Bash است. می توانید از آن برای ذخیره
خروجی برنامه، ذخیره ورودی کاربر یا ایجاد فایل های پیکربندی استفاده کنید. دانستن 
نحوه نوشتن در یک فایل با استفاده از Bash برای کارهای اتوماسیون و اسکریپت نویسی مفید
است.

این مقاله روش های مختلفی برای نوشتن در فایل ها در Bash را پوشش می دهد، از تغییر 
مسیر ساده گرفته تا استفاده از حلقه ها و جایگزینی فرمان برای کارهای پیشرفته تر.

## استفاده از تغییر مسیر خروجی

در Bash، می توانید از عملگرهای تغییر مسیر خروجی `>`و `>>`برای نوشتن در یک فایل استفاده
کنید.

### بازنویسی فایل با استفاده از`>`

از این `>`عملگر برای بازنویسی کامل یک فایل موجود یا ایجاد یک فایل جدید استفاده کنید.

کنسول

    ```
    $ echo "Hello from negarnovin!" > output.txt
    ```

این دستور:

 * `output.txt`اگر وجود نداشته باشد، ایجاد می کند و می نویسد `Hello from negarnovin!`.
 * اگر فایل وجود داشته باشد، محتوای آن با جایگزین می شود `Hello from negarnovin!`.

### اضافه کردن به فایل با استفاده از`>>`

از این `>>`عملگر برای افزودن داده ها بدون بازنویسی محتوای موجود آنها استفاده کنید.

کنسول

    ```
    $ echo "Greetings from negarnovin!" >> output.txt
    ```

این خط را `Greetings from negarnovin!`به انتهای اضافه می کند `output.txt`و محتوای
موجود را حفظ می کند. این به حفظ گزارش ها یا ذخیره تدریجی داده ها در یک فایل کمک 
می کند.

## نوشتن خروجی یک دستور در یک فایل

شما می توانید خروجی هر دستوری را به یک فایل هدایت کنید.

 * یک فایل را با خروجی دستور بازنویسی می کند.
 * کنسول
 *     ```
       $ ls -l /home/user > bash_file.txt
       ```
   
 * این دستور لیست فایل های موجود در `/home/user`دایرکتوری را در ذخیره می کند و `
   bash_file.txt`محتوای موجود را جایگزین می کند.
 * یک فایل به خروجی دستور پیوست کنید.
 * کنسول
 *     ```
       $ df -kh >> bash_file.txt
       ```
   
 * این کار محتوای موجود را نگه می دارد و ورودی های جدید را به انتهای فایل اضافه 
   می کند.
 * همچنین می توانید هم خروجی استاندارد و هم خطای استاندارد را به یک فایل تغییر مسیر
   دهید. در Bash، `1`‎stdout‎ و `2`‎stderr‎ را نشان می دهد.
 * کنسول
 *     ```
       $ ls /home/user /nonexistent > bash_output.txt 2>&1
       ```
   
 * در اینجا، `2>&1`خطای استاندارد (stderr) را به همان محل stdout تغییر مسیر می دهد.
   این کار هنگام گرفتن خروجی کامل دستور، از جمله خطاها، مفید است.

## `tee`برای نوشتن و نمایش خروجی استفاده می شود

 * این `tee`دستور به شما امکان می دهد خروجی را هم در ترمینال و هم در یک یا چند فایل
   بنویسید.
 * کنسول
 *     ```
       $ echo "Logged line" | tee bash_log.txt
       ```
   
 * برای اضافه کردن به جای بازنویسی، از `-a`پرچم استفاده کنید.
 * کنسول
 *     ```
       $ echo "Another line" | tee -a bash_log.txt
       ```
   
 * این قابلیت هنگام اشکال زدایی یا زمانی که خروجی نیاز به ذخیره و نظارت همزمان دارد،
   مفید است.

## از یک سند اینجا استفاده کنید

Heredoc به شما امکان می دهد متن چندخطی را به یک دستور ارسال کنید. می توانید از آن
به همراه `cat`یا `tee`برای نوشتن محتوای چندخطی در یک فایل در Bash استفاده کنید. 
این دستور با ‎ ‎ شروع می شود و `<<`به دنبال آن جداکننده مشخص شده (مثلاً `EOF`‎) 
قرار می گیرد.

bash

    ```
    cat <<EOF > bash_config.txt
    server=localhost
    port=8080
    enabled=true
    EOF
    ```

 * Heredoc را شروع `<<EOF`می کند و `EOF`به عنوان جداکننده تعریف می شود، به این معنی
   که دستور خط را تا زمانی که با مواجه شود، می خواند `EOF`.
 * `>`تغییر مسیر خروجی است .

این دستور `bash_config.txt`بلوک پیکربندی مشخص شده را ایجاد یا با آن رونویسی می کند.

اگر می خواهید خطوط را به جای رونویسی، اضافه کنید، از `>>`redirector استفاده کنید.

bash

    ```
    cat <<EOF >> bash_config.txt
    # Additional settings
    log_level=debug
    EOF
    ```

با استفاده از این روش، اسکریپت می تواند فایل های پیکربندی ساختاریافته تولید کند.

## نوشتن در فایل در یک حلقه

شما می توانید چندین بار درون یک حلقه در یک فایل بنویسید. این برای تولید لاگ ها یا
ایجاد فایل های ساختاریافته مفید است.

bash

    ```
    for i in {1..3}; do
     echo "Line $i" >> bash_loop_output.txt
    done
    ```

هر تکرار حلقه یک خط جدید به اضافه می کند `bash_loop_output.txt`.

## مدیریت خطاها هنگام نوشتن در فایل ها

این بخش نحوه مدیریت اسکریپت را در زمانی که عملیات نوشتن در اسکریپت شما با شکست مواجه
می شود، نشان می دهد.

 * برای اطمینان از موفقیت آمیز بودن نوشتن، وضعیت خروج دستور را بررسی کنید.
 * bash
 *     ```
       echo "Test write" > bashfile.txt
       if [ $? -eq 0 ]; then
        echo "Write successful."
       else
        echo "Write failed."
       fi
       ```
   
 * این `$?`متغیر وضعیت خروج دستور قبلی را ذخیره می کند. همچنین می توانید `set -e`
   قبل از دستور write یک خط اضافه کنید. این کار باعث می شود در صورت عدم موفقیت هر
   دستوری، اجرای اسکریپت متوقف شود.
 * همچنین می توانید قبل از اقدام به نوشتن، مجوزهای فایل را با استفاده از بررسی کنید`-
   w`.
 * bash
 *     ```
       if [ -w bashfile.txt ]; then
        echo "Writable"
       else
        echo "No write permission"
       fi
       ```
   
 * این بررسی می کند که آیا `bashfile.txt`قابل نوشتن است یا خیر و بر اساس آن پیامی
   را خروجی می دهد.

## استفاده از توصیف گرهای فایل برای کنترل پیشرفته

اگر اسکریپت شما خروجی را در چندین فایل (یا جریان خروجی) می نویسد، می توانید با استفاده
از `exec`دستور، آنها را با یک مقدار عددی برچسب گذاری کنید. این یک توصیف گر فایل 
ایجاد کرد. برای بستن آن، باید یک خط اضافه کنید `exec <descriptor>&-`.

همانطور که قبلاً ذکر شد، در Bash، `1`‎ نشان دهنده stdout و `2`stderr است. بنابراین
می توانید به جریان های خروجی خود مقادیری بزرگتر از ‎ اختصاص دهید `2`.

bash

    ```
    exec 3> bash_custom_output.txt
    echo "Writing with FD 3" >&3
    exec 3>&-
    ```

 * این توصیفگر فایل را `3`برای نوشتن باز می کند
 * `Writing with FD 3`برایش می نویسد .
 * توصیفگر فایل را می بندد `3`.

## نتیجه گیری

اکنون شما روش های مختلف نوشتن در فایل ها در Bash را درک می کنید – از تغییر مسیر 
و خروجی دستور گرفته تا استفاده از `tee`حلقه ها، Heredoc و توصیف گرهای فایل. ترکیب
این تکنیک ها را برای ساخت اسکریپت های قدرتمندتر و انعطاف پذیرتر تمرین کنید.
